Overview: Query Builder for Google BigQuery
How to access the Query Builder for BigQuery
Navigate to Metrics > Query Builder to access the Query Builder for BigQuery. Click the green + Create Custom Metric button and select your connected BigQuery 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
How to use the Query Builder for BigQuery
- 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.
How to create a Custom BigQuery Metric [Example]
The Query Builder for BigQuery is designed so you can directly enter SQL queries. For our example, we will use a BigQuery Data Source and create a Custom Metric that returns a list of Authors and their associated Review Scores.
SELECT date(time_ts) AS date, score, author FROM [bigquery-public-data:hacker_news.stories] ORDER BY score DESC LIMIT 10;
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.
How to add a Custom BigQuery Metric to a Databoard
Learn how to add a Custom Metric to a Databoard here.