CData Excel Add-In for Google BigQuery 2019 - Online Help
Questions / Feedback?

Establishing a Connection

CData Excel Add-In for Google BigQuery 2019 - Build 19.0.7354

Configure a Connection Profile

Click From Google BigQuery to launch the connection dialog. Here, you can set the connection settings, test the connection, and save the connection profile. The profile enables you to control the following for a connection:

  • Workbook Sharing

    Select the Store in Workbook option to create easy-to-share spreadsheets. By default, the add-in saves the connection to an .rdc file in the CData subfolder in the %APPDATA% folder.

  • Read/write access

    Enable or restrict updates, deletes, and inserts for the connection.

Authenticate via OAuth Authentication

Use the OAuth authentication standard to connect to Google BigQuery. You can authenticate with a user account or with a service account. A service account is required to grant organization-wide access scopes to the add-in. The add-in facilitates these authentication flows as described below.

Authenticate with a User Account

You can connect without setting any connection properties for your user credentials. After setting the following, you are ready to connect:

  • DatasetId: Set this to the Id of the dataset you want to connect to.
  • ProjectId: Set this to the Id of the project you want to connect to.
When you connect the add-in opens the OAuth endpoint in your default browser. Log in and grant permissions to the application. The add-in then completes the OAuth process.

See Using OAuth Authentication for other OAuth authentication flows.

Authenticate with a Service Account

Service accounts have silent authentication, without user authentication in the browser. You can also use a service account to delegate enterprise-wide access scopes to the add-in.

You need to create an OAuth application in this flow. See Creating a Custom OAuth App in the Getting Started section to create and authorize an app. You can then connect to Google BigQuery data that the service account has permission to access.

After setting the following connection properties, you are ready to connect:

  • OAuthJWTCertType: Set this to "PFXFILE".
  • OAuthJWTCert: Set this to the path to the .p12 file you generated.
  • OAuthJWTCertPassword: Set this to the password of the .p12 file.
  • OAuthJWTCertSubject: Set this to "*" to pick the first certificate in the certificate store.
  • OAuthJWTSubject: Set this to the email address of the user for whom the application is requesting delegate access. Note that delegate access must be granted by an administrator.
  • OAuthJWTIssuer: In the service accounts section, click Manage Service Accounts and set this field to the email address displayed in the service account Id field.
  • DatasetId: Set this to the Id of the dataset you want to connect to.
  • ProjectId: Set this to the Id of the project you want to connect to.
When you connect the add-in completes the OAuth flow for a service account.

See Also

  • Querying Data: Use the data selection wizard to pull data into a spreadsheet. You can also configure scheduled data refresh here.
  • Using the Excel Add-In: Find other ways to interact with Google BigQuery data, such as using the available CData Excel Formulas.
  • Managing Connections: To access an existing connection, click Edit in the Connection Wizard or click Existing Connections in the CData ribbon. Additionally, see this section for more information on workbook sharing and user access.

Copyright (c) 2020 CData Software, Inc. - All rights reserved.
Build 19.0.7354.0