Enabling the BigQuery Data Transfer Service

To use the BigQuery Data Transfer Service, you must complete the following steps as a project Owner:

  • Create a project and enable the BigQuery API
  • Enable the BigQuery Data Transfer Service

For more information on Cloud IAM roles, see Understanding roles in the Cloud IAM documentation.

Creating a project and enabling the BigQuery API

Before using the BigQuery Data Transfer Service, you must create a project and, in most cases, enable billing on that project. You can use an existing project with the BigQuery Data Transfer Service, or you can create a new one. If you are using an existing project, you may also need to enable the BigQuery API.

To create a project and enable the BigQuery API:

  1. In the Cloud Console, go to the project selector page.

    Go to the project selector page

  2. Select or create a Cloud project.

  3. You will need to enable billing on your project if you want to transfer data from any of these sources: Enabling billing is only required once per project, even if you are transferring data from multiple sources. You may also need to enable billing if you need to query the data in BigQuery.

  4. Make sure that billing is enabled for your Google Cloud project. Learn how to confirm billing is enabled for your project.

  5. BigQuery is automatically enabled in new projects. To activate BigQuery in an existing project, Enable the BigQuery API.

    Enable the API

Enabling the BigQuery Data Transfer Service

Before you can create a transfer, you must enable the BigQuery Data Transfer Service. To enable the BigQuery Data Transfer Service, you must be granted the Owner role for your project.

To enable the BigQuery Data Transfer Service:

Console

  1. Open the BigQuery Data Transfer API page in the API library.

  2. From the dropdown menu, select the appropriate project.

  3. Click the ENABLE button.

    Enable the Data Transfer API

Classic UI

  1. Go to the classic BigQuery web UI.

    Go to the classic BigQuery web UI

  2. Click Transfers.

  3. Click Enable to grant permissions to the BigQuery Data Transfer Service. The first time you enable transfers in a project, you are required to grant permissions to the BigQuery Data Transfer Service. After permissions are granted, you are not prompted again.

    Enable transfers

Granting bigquery.admin access

All users that will create transfers must be granted the bigquery.admin predefined Cloud IAM role. The bigquery.admin role includes the following BigQuery Data Transfer Service permissions:

  • bigquery.transfers.update
  • bigquery.transfers.get

The bigquery.admin role also includes the bigquery.datasets.update permission. Thebigquery.datasets.update permission is required to write data to the transfer's destination dataset.

To grant the bigquery.admin role:

Console

  1. Open the Cloud IAM page in the Cloud Console

    Open the IAM page

  2. Click Select a project.

  3. Select a project and click Open.

  4. Click Add to add new members to the project and set their permissions.

  5. In the Add members dialog:

    • For Members, enter the email address of the user or group.
    • In the Select a role drop-down, click BigQuery > BigQuery Admin.

    • Click Add.

      Grant admin

CLI

You can use the gcloud command-line tool to grant a user or group the bigquery.admin role.

To add a single binding to your project's Cloud IAM policy, type the following command. To add a user, supply the --member flag in the format user:user@example.com. To add a group, supply the --member flag in the format group:group@example.com.

gcloud projects add-iam-policy-binding project_id \
--member group/user:address \
--role roles/bigquery.admin

Where:

  • project_id is your project ID.
  • group/user is either group or user.
  • address is the user or group's email address.

For example:

gcloud projects add-iam-policy-binding myproject \
--member group:group@example.com \
--role roles/bigquery.admin

The command outputs the updated policy: 

    bindings:
    - members:
      - group:group@example.com
        role: roles/bigquery.admin

For more information on Cloud IAM roles in BigQuery, see Predefined roles and permissions.

Next steps

After enabling the BigQuery Data Transfer Service, create a transfer for your data source.

Google Software as a Service (SaaS) apps External cloud storage providers Data warehouses In addition, several third-party transfers are available in the Google Cloud Marketplace.