Search results

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

  1. Select your project from the dropdown.

ServiceAuth

  1. Click Create Service Account

ServiceAuth

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

ServiceAuth

  1. In the Service account description field, enter a description. For example, Service account for quickstart.
  1. Click Create and continue.

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

ServiceAuth

  1. 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.

  1. 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.

ServiceAuth

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

ServiceAuth

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

ServiceAuth

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.

Google BigQuery Console Project

Create a new project as follows.
Google BigQuery Create Project

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

Enable Google People API

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.

Set Application Type

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

Set Application Name

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

Set Domain Information

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.

Set Authorized Information

Add Test Users

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

Set Test Users

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

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

Google BigQuery Credentials Create

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

Google BigQuery Credentials Page Open Google BigQuery Credentials Page Save

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.

IntermediateDB Set Error

Then, configure the intermediate DB in Data Store section.

Data Store Page

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

Connectors Page

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.

    Data source icon

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

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

    Choose data source

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.

Choose data source server

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.

    Google BigQuery Login

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

    Google BigQuery Login Allow

    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.

    Google BigQuery Connect Account

  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

Google BigQuery Connection

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.

Google BigQuery Connection

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.

Treev view

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

Tree view specific dataset

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

    Query Editor

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

    Code view

  2. 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.

OAuth

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

Manage Accounts

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.

Data Transformation

Editing a Data Connection

Dashboard Designer Walkthrough

Google BigQuery Limitations to build query

Linking Google BigQuery with Google Analytics

Google BigQuery Integration