Overview: Query Builder for MySQL

HOW TO

How to access the Query Builder for MySQL

Navigate to   Data Manager > Query Builder to access the Query Builder for MySQL. Click the green + Create Custom Metric button and select your connected MySQL Data Source from the Data Source drop-down list.

    Query Builder is available in Plus and Business Accounts. Agency Basic Accounts have access to Query Builder in the Agency Account only.  Request a trial of Query Builder by following these steps.

How to use the Query Builder for MySQL

add_user_popup@2x

A
   Custom Metric Name: Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving. 
B
   SQL: Construct query strings to access data from your Database using Structured Query Language (SQL). 
Learn more about SQL here
C
   Data Type: Selecting the appropriate Data Type ensures that your Custom Metrics will be synced correctly in Databox. 
  • Daily Values: This Data Type should be selected when your Metric reflects the most up-to-date Daily Value for the Metric. In Databox, the latest daily entry will be displayed for the Custom Metric.
  • Total Values: This Data Type should be selected when your Metric reflects the current total Value for the Metric.  In Databox, the latest entry will be displayed for the Custom Metric.

    For longer Date Ranges, data will be not aggregated and the most recent Value will be displayed for the selected Date Range. This is the main difference between "Total Values" and "Daily Values." 
  • Event Values: This Data Type should be selected when your Metric Value selection reflects individual Value(s) for the Metric at the specified Date/ Timestamp. This Data Type is the default selection because it is appropriate for the majority of use cases. 

    For longer Date Ranges, individual Metric Values will be aggregated for the entire Date Range and the aggregated Value will be displayed for the Custom Metric. 
D
   Data Preview: After clicking Run query, a Data Preview of the Custom Metric will be displayed. Daily Metric values are displayed in this section, along with the total Metric values for the Date Range in bold at the bottom. You can view the Data Preview for different Date Ranges by clicking on the tabs at the top of the Data Preview. 

How to create a Custom MySQL Metric [Example]

The Query Builder for MySQL is designed so you can directly enter SQL queries. For our example, we will use a WordPress MySQL Data Source and create a Custom Metric that returns a list of WordPress authors and their current post count. 

1
 Navigate to  Data Manager > Query Builder    
2
 Click the green  + New query button
3
 Select the appropriate MySQL Data Source
4
 In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric "Authors by Post Count" 
5
  In the SQL field, we will enter the query below. A semicolon at the end of the query is not necessary
SELECT COUNT(p.ID) AS posts, u.display_name, p.date AS date FROM dbwp_users u, dbwp_posts p WHERE p.post_author = u.ID AND p.post_type = 'post' GROUP BY u.ID
				
We used the   AS SQL construct in our query (i.e.  AS posts). This is not mandatory, but it will set the data as a Metric Key. If you use  AS date , this column will represent the Date and Time of the Metric Value ( ISO 8601 Standard Date and Time Format is supported). 
6
 We will select Total Values as the Data Type. This selection is based on the way data is stored and updated in our Database
7
 Click Run query to generate a Data Preview of the Custom Metric

If you don’t see any data, double check your SQL query and try it directly in your Database. If no results are displayed there, an error exists in your query. You should also chec to confirm that the MySQL user has the necessary permissions to access the Database from Databox's public IP. 

8
 Once we confirm that these are the results we're looking for, we'll click Save to save the Custom Metric

How to add a Custom MySQL Metric to a Databoard

Learn how to add a Custom Metric to a Databoard here

Additional Information

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us