Connecting to BigQuery
To authorize the BigQuery connection, you need to create a service account and create a security key for it.
To create the service account, perform the following steps:
- Login to your Google API Console.
- Select the required project from the list:
- Make sure that current account is linked to a billing account. To check this, select the icon and then select Billing .
- On the API Manager page, select Credentials :
- On the Credentials page, select Manage service accounts .
- On the Service Accounts page, click Create Service Account and specify the following:
- Service account name
- Role - grant this service account role based access to the project. From the list, select the BigQuery category and then select BigQuery Data Viewer and BigQuery User roles.
- Service account ID
- Click Create .
When you have created an account, you need to create a security key for it. Perform the steps listed below:
- On the Service Accounts page, find the required account.
- From the menu, select Create key .
In the Create private key dialog box, select the JSON key type and click Create . The local copy of the key will be saved on your computer.
- Move the file with the key to the server, on which the connector is running.
The table below lists information on the features that are supported by BigQuery:
|Supports Distinct Count?||Yes|
|Supports Live Mode/ Playback?||Yes|
|Supports Group-by Time?||Yes|
|Supports Multi Group-by Charts?||Yes|
|Supports Box Plot?||No|
|Custom SQL Capable?||No|
|Supports Last Value?||No|
CONFIGURING THE CONNECTION
For details about what is provided on each page of the connection process, review the article Source Connection Workflow . Depending on your needs, you can either follow the steps in order from start to finish or jump to a specific section in the connection process:
- General Page
When the connector server is set up by the Zoomdata Administrator, certain parameters on the Connectors page may be customized. The instructions below assumes that the default configuration parameters were kept. If this is not the case, then your Connection page may differ slightly from the screen captures and references provided.
- Tables Page
- Fields Page
- Refresh Page
- Charts Page
Log into Zoomdata.
Administrators and users with appropriate access privileges can connect data sources in Zoomdata.
Click the Sources menu item.
- Click the BigQuery connector icon.
- Specify the name of your source and add a description (if desired).
This page defines the connection source for Zoomdata to be able to access the data source. If this is the first time setting up a connection, then you need to input the necessary credentials. If a validated connection already exists, you are given the option to use it.
- To create a new connection, select the Input New Credentials option.
- Enter a unique name for the connection (to help distinguish between other connections in this Zoomdata account).
- Specify the Key Path.
If successfully validated, the connection is saved.
- Click Next to continue to the next setup page.
- Select the schema and data table to use for your charts.
- Toggle the availability of the fields, as needed.
- Toggle the SparkIt and Caching options, as needed.
- Click Next to continue.
The Fields page lets you (1) configure attribute options, (2) create custom labels for the fields in your data source (that will be displayed in the charts), (3) manage the Volume metric, and (4) work with Calculations.
- Determine whether the field should be visible or not to the user.
- Create unique label names, as needed, for each Label field.
- For the Type column, you have the option to edit the field type (although usually you won't need to do this).
- Configure the partition settings. For the partitioned fields you can select one of the following options:
- Date - this option is available for the Time field type. If you select this option, the list of the partitioned columns will be displayed in the Configure column.
- For the Configure column, numeric and time-based fields may be edited:
- Numeric types including Money, Number and Integer - ability to select a default aggregation function
- Time fields - ability to define the default time pattern and granularity; if the time field provides granularities of hour, minute and second, then a time zone label may be applied
Select fields for
When you create a data source, the specific number of distinct values for the attribute fields are saved in Zoomdata depending on the data sample from your data set. You can filter the data on your chart by these values. While editing a data source, if you want to use all distinct values in the filter (that is from whole data source), click the Refresh button in the Statistics column.
- Refresh the connection to a particular field, as desired.
- Configure Filter Display settings for fields.
- Edit the Volume Metric settings, as needed.
, if available and as needed.
If you are setting up a new connection, the Calculations section will not be available until after the connection is saved.
- Click Next to continue.
The Refresh page lets you schedule asynchronous jobs to update the source metadata. For guidance to set up a refresh schedule, refer to the article Using the Zoomdata Scheduler .
On the Charts page, you can:
- Edit Global Default Settings.
- Select the Standard and, if available, Custom chart styles to be used with the data source.
- Set default parameters (group, sub-group, colors, sorting, and so on) for each chart style.
Click Finish to save your changes. Once your data connection has been established, it will be listed under the My Data Sources section of the page.