> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google BigQuery

You can use the Google BigQuery connector from the CData Sync application to move data
from any supported source to the Google BigQuery destination. To do so, you need to add
the connector, authenticate to the connector, and complete your connection.

## Add the Google BigQuery Connector

To enable Sync to use data from Google BigQuery, you first must add the
connector, as follows:

<ol>
  <li>Open the **Connections** page of the Sync dashboard.</li>
  <li>Click **Add Connection** to open the **Select Connectors** page.</li>
  <li>Click the **Destinations** tab and locate
  the **Google BigQuery** row.</li>

  <li>
    Click the **Configure Connection** icon at the end of that row to open
    the **New Connection** page. This action opens the
    **Add Connection** dialog.

    **Note:** If the **Configure Connection** icon is not
    available, click the **Download Connector** icon to install
    the Google BigQuery connector.
  </li>

  <li>Enter a name for your connection in the **Add Connection** dialog.</li>
  <li>Click **Add** to open the **Settings** tab for your connector.</li>
</ol>

For more information about installing new connectors, see
[Connections](https://docs.sync.cdata.com/26.4/en/connections/connections.md).

## Authenticate to Google BigQuery

After you add the connector, you need to set the required properties.

CData Sync supports authenticating to Google BigQuery in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

* [**OAuth**](#oauth)
* [**OAuth JWT**](#oauth-jwt)
* [**GCP Instance Account**](#gcp-instance-account)
* [**AWS Workload Identity**](#aws-workload-identity)

### OAuth

CData Sync provides an embedded OAuth application with which to connect. To use the application, select **OAuth** for **Auth Scheme**. No additional properties are required.

### OAuth JWT

To connect with a Google service account, specify the following properties:

* **Auth Scheme:** Select **OAuthJWT**.
* **OAuth JWT Cert:** Enter your Java web tokens (JWT) certificate store.
* **OAuth JWT Cert Type:** Enter the type of key store that contains your JWT Certificate. The default type is **GOOGLEJSONBLOB**.
* **OAuth JWT Subject:** Enter the user subject for which the application is requesting delegated access.

### GCP Instance Account

When you run CData Sync on a GCP virtual machine, Sync can authenticate by using the service account that is tied to the virtual machine. Select **GCPInstanceAccount** for **Auth Scheme** to use that account. No additional properties are required.

### AWS Workload Identity

To connect by using Workload Identity Federation via AWS, specify the following properties:

* **Auth Scheme:** Select **AWSWorkloadIdentity**.
* **AWS Workload Identity Config:** Enter the configuration properties that you want to provide when you us Workload Identity Federation via Amazon Web Services (AWS).
* **Workload Pool Id:** Enter the identifier (Id) of your Workload Identity Federation pool.
* **Workload Project Id:** Enter the Id of the Google Cloud project that hosts your Workload Identity Federation pool.
* **Workload Provider Id:** Enter the Id of your Workload Identity Federation pool provider.

## Complete Your Connection

To complete your connection:

1. Specify the following settings:
   * **Project Id:** Enter the identifier of the project to which Sync should connect.
   * (Optional) **Dataset Id:** Enter the identifier of the data set to which Sync should connect.
   * **Insert Mode:** Select the method that you want to use to insert data. The default method is **Streaming**.
     * **Streaming**
     * **DML**
     * **Upload** (default)
     * **GCSStaging:** For this mode, you need to specify these properties:
       * **GCS Bucket:** Enter the name of a GCS bucket that you want to use to upload bulk data for staging.
       * (Optional) **GCS Bucket Folder:** Enter the name of the specific folder in the GCS bucket where you want to upload bulk data for staging.
2. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
3. If you authenticate with oauth, click **Connect to Google BigQuery** to connect to your Google BigQuery account.
4. Click **Create & Test** to create your connection.

## More Information

For more information about interactions between CData Sync and Google BigQuery, see
[Google BigQuery Connector for CData Sync](https://cdn.cdata.com/help/DBN/synch/default.htm).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.