Connecting Bold BI to Google BigQuery data source

Bold BI dashboard designer supports connecting Google BigQuery server using the Live mode.

Prerequisites for Embedded BI version

NOTE: This is only applicable for Embedded BI version and if you are using cloud Bold BI product, simply skip this step.

Authentication Types:

1. OAuth

2. Service Account

Connecting with Service Authentication:

Create a service account:

1. Go to the Create service account page in the Google Cloud console.

https://console.cloud.google.com/projectselector2/iam-admin/serviceaccounts

2. Select your project from the dropdown.

3. Click Create Service Account

4. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

5. In the Service account description field, enter a description. For example, Service account for quickstart.

6. Click Create and continue.

7. To provide access to your project, grant the following role(s) to your service account: Project > Owner.

8. In the Select a role list, select a role and Click Continue.

For additional roles, click add Add another role and add each additional role.

NOTE: The Role field affects which resources your service account can access in your project. You can revoke these roles or grant additional roles later. In production environments, do not grant the Owner, Editor, or Viewer roles in production environments. Instead, grant a predefined role or custom role that meets your needs.

8. Click Done to finish creating the service account. Do not close your browser window. You will use it in the next step.

Create a service account key:

1. In the Google Cloud console, click the email address for the service account that you created.

2. Click context menu and select Manage Keys.

3. Click Add key, and then click Create new key.

4. Click Create. A JSON key file is downloaded to your computer.

Connecting with OAuth:

1. Go to your personal or organization accounts for Google developer console and create a project or application

Google BigQuery console link: https://console.cloud.google.com/bigquery

You can see the projects list as follows.

Create a new project as follows.

2. Enable a Google BigQuery API

Go to the following link and enable the Google developers console API.

https://console.developers.google.com/apis/library/people.googleapis.com

You can edit or view your OAuth grant limit, redirect URI, scope, authorized domains, and more using the following link.

https://console.cloud.google.com/apis/credentials/consent

Select OAuth Consent screen tab and choose external user type as shown in the following image.

Enter the app’s name and user’s email address, as shown in the following image.

Enter the app domain information for registering the application with Bold BI as follows.

Set the authorized domain as boldbi.com and enter the User’s email address mail for development contact information as shown in the following image.

Add Test Users

Click Add Users and enter the user’s email address and click Save, as shown in the following image.

To Create a new Credentials (Client ID, Client Secret), use the following link.

https://console.cloud.google.com/apis/credentials

After creating the credentials, open the corresponding credentials and add your Bold BI Enterprises build hosted URL as the following sample URL format.

http://localhost:<boldbi-running port>/bi/designer/v1.0/oauth/agent

3. Go to Bold BI application and navigate to data connectors settings page

If intermediate DB is not configured, you will get an error as follows.

Then, configure the intermediate DB in Data Store section.

Also, configure the client ID and client secret information in Connectors section and save the information for Google BigQuery as follows.

Once the pre-requisites done, you are good to go to work with Google BigQuery.

Choose a Google BigQuery data source

To configure the Google BigQuery data source, follow these steps:

1. Click the Data Sources button in the configuration panel to add a new data connection.

   

2. Click CREATE NEW to launch a new connection from the connection panel.

3. Select the Google BigQuery connection in the connection panel.

   

NOTE: You can also create a data source from the home page by clicking the Data Sources menu from left menu panel and Create Data Source from the data sources page.

Authentication with Google BigQuery

Use the following steps to authenticate with Google BigQuery server:

1. Click the data source, you will be prompted with a login window. Enter the credentials of your Google BigQuery account to authorize.

   

2. Click Allow in the authorization window to accept the scopes requested by Bold BI dashboards.

   

   NOTE: If the permission is denied, the account will not be accessible from the dashboard.

3. Set a name to identify the account and click Next.

4. Now, you have successfully authorized your connection. Click Connect to continue with the data source connection.

   

5. To connect using the already connected account, refer to Connected Accounts.

NOTE: To connect to another account, click Connect New Account.

Connect to Google BigQuery

Create a Google BigQuery data source

After successful authentication, the NEW DATA SOURCE configuration panel opens.

Follow these steps to create the Google BigQuery data source.

Enter the data source’s name and description (optional).

Select the Authentication Type.

For Service Authentication:

Select the JSON file downloaded from Connecting with Service Authentication

For OAuth:

The authentication type will automatically be sent to the Google BigQuery in the Connected as text box since the OAuth is used for authenticating with the Google BigQuery account.

Choose the required projects in the Project drop-down box.

To connect the Google Big Query with a particular dataset, enter the property currentdataset={datasetname} or specificdataset={datasetname} in the Additional connection parameters text box.

To edit the connection information, use the Edit Connection option.

Preview data

1. Click Connect to connect the Google BigQuery server with configured details.

The available datasets list is shown in a tree view for the selected projects that are retrieved from the Google BigQuery server.

If the dataset name is provided in Additional connection parameters text box, only the specified dataset will be listed.

2. In the data design view page, drag, and drop the table.

   

   You can use Code View options for passing query to display data.

   

3. Click Save to save the data source with relevant name.

Connected accounts for OAuth data sources

If you have already logged into the account and authenticated with the data source, the account information will be listed here. You can select one of the accounts or connect to a new account by clicking the Connect New Account button.

You can edit, delete, and re-authorize this account from the Connected Accounts page.

Link Google BigQuery data source with Google Analytics

Google BigQuery is a data warehouse and only supports live connection in Bold BI. You can link your Google BigQuery with Google Analytics by following the official documentation steps about linking Google BigQuery with Google Analytics.

Related links

Data Transformation

Editing a Data Connection

Dashboard Designer Walkthrough

Google BigQuery Limitations to build query

Linking Google BigQuery with Google Analytics

Google BigQuery Integration