BigQuery Reverse ETL Setup

Set up BigQuery as your Reverse ETL source.

To set up the Segment BigQuery connector:

1. Navigate to IAM & Admin > Service Accounts in BigQuery.
2. Click + Create Service Account to create a new service account
3. Enter your Service account name and a description of what the account will do
4. Click Create and Continue.
5. In the Grant this service account access to project section, select the BigQuery User role to add.
6. Click + Add another role and add the BigQuery Job User role.
7. Click Continue.
8. Click Done.
9. Search for the service account you just created.
10. When your service account pulls up, click the 3 dots under Actions and select Manage keys.
11. Click Add Key > Create new key.
12. In the pop-up window, select JSON for the key type and click Create. The file will download.
13. Copy all the content within the file you just created and downloaded.
14. Navigate to the Segment UI and paste all the credentials you copied from step 13 into the Enter your credentials section.
15. Enter your Data Location.
16. Click Test Connection to test to see if the connection works. If the connection fails, make sure you have the right permissions and credentials and try again.
17. Click Add source if the test connection is successful.

After you’ve added BigQuery as a source, you can add a model.

Constructing your own role or policy

When you construct your own role or policy, Segment needs the following permissions:

If you don’t want to grant Segment bigquery.datasets.create access, you can create your own __segment_reverse_etl dataset and give Segment the following permissions:

The bigquery.datasets.* permissions can be scoped only to the __segment_reverse_etl dataset.

After you’ve successfully added your BigQuery source, add a model and follow the rest of the steps in the Reverse ETL setup guide.