NOTE: Certain information in this article may be missing or out of date. We are in the process of updating the content.
Overview
Google BigQuery is Google’s fully managed, petabyte scale, low-cost enterprise data warehouse for analytics. Here are some things you can expect from the Google BigQuery/Grow integration.
How to Connect
Before you get started you will need your Google BigQuery Project ID, Client Email and Private Key or you can upload a JSON file with your project ID, email, and private key.
- Click on the Data tab at the top left of the global navigation. Then click on "Connections" in the Data Library section.
- Click on the blue "Connect" button and search for BigQuery.
- Click on the BigQuery logo.
- The most straightforward way to connect your BigQuery account is to click “Fill in manually” on the authorization page. You’ll need the BigQuery project ID you want to connect, the email address associated with the BigQuery account, and your private key.
- If you don’t know what your private key is or how to get it, Google has a helpful article on how to do so. You have to do a bit of scrolling through the page to get to what you need, so we’ve copied the important stuff here:
To generate a private key in JSON or PKCS12 format in Google BigQuery:
- Open the list of credentials in the Google Cloud Platform Console.
- Click Create credentials.
- Select Service account key. A Create service account key window opens.
- Click the drop-down box below Service account, then click New service account.
- Enter a name for the service account in Name.
- Use the default Service account ID or generate a different one.
- Select the Key type: JSON or P12.
- Click Create. A Service account created window is displayed and the private key for the Key type you selected is downloaded automatically. If you selected a P12 key, the private key's password ("notasecret") is displayed.
- Highlight and copy your private key.
You can then come back to Grow and paste the key into the Private Key field. You'll need to also enter your email associated with BigQuery and your Project ID.
Alternatively, if you have the know-how and would prefer to upload a JSON file with your project ID, email, and private key, that will work as well.
When you've entered in this information, press the Submit button.
And that’s it! You are good to go.
Endpoints
Below is a list of the reports you can pull from BigQuery, along with a description of the fields available with each report.
- Datasets: All datasets associated with projects under the connected BigQuery account, including kind, dataset ID, dataset reference, and project ID.
- Tables: All tables for the selected dataset, including kind, table ID, project, dataset, table name, type, and unix epoch creation time.
- Table Data: All table data for the selected dataset and table. The fields returned here will vary based on the specifics of the datasets created with BigQuery.
- Custom SQL Query: Write custom SQL queries to hone in on specific fields when building a metric.
FAQs + Tips and Tricks
Permissions for Connecting to BigQuery using the Grow Warehouse
When connecting to Google BigQuery using the Grow Warehouse make sure you have the correct roles and permissions assigned. The user who is connecting BigQuery to Grow needs to have the assigned role of roles/bigquery.jobUser then also have the permission bigquery.jobs.create. Assigning this role and permission will allow you to run jobs including queries inside projects.
For more in-depth information on roles and permissions see "Predefined roles and permissions".
Unix Epoch Dates
Some datatable information fields include creation dates in unix epoch format. This will just look like a string of random numbers. Luckily, there’s a quick way to fix that, either through Grow’s table date format function in the edit metric screen, or with a relatively simple SQL query.
How can I make sure my data is secure?
We have several items in place to keep your data safe. Check out our security article to see what steps you can take to keep control of your data.