The following steps will walk you through creating a service account for Datafold to have read-access to your datasets and write-access to a new temporary table.
Steps to complete:

To connect Datafold to your BigQuery project, you will need to create a service account for Datafold to use.
  • Navigate to the Google Developers Console. Before proceeding, click on the drop-down to the left of the search bar and select the project you want to connect to.
  • If you do not see the project, you would like to connect to listed in the drop-down, click on the account switcher in the upper right corner of the window and ensure you are logged in to a Google account that is a member of the project.
  • Click on the hamburger menu in the upper left and select IAM & Admin, and then Service Accounts.
  • Create the service account and name it Datafold

For Datafold we require the BigQuery Data Viewer for read access on all the datasets in the project. We need the BigQuery Job User to run queries. Next to that Datafold requires the BigQuery Resource Viewer role for fetching the query logs to parse lineage.

We need to set one more permission on Datafold's temporary dataset. Let's navigate to BigQuery in the console. Datafold requires read permissions on all the datasets that contain user data but needs one dataset to materialize in between datasets. By materializing this data in BigQuery we reduce the volumes of data that are being processed in Datafold itself.
Give the dataset a name that is related to Datafold, in the example we call it datafold_tmp.
Make sure that the dataset lives in the same region as the rest of the data, otherwise, the dataset will not be found.
Datafold requires the BigQuery Data Editor role on the newly created Dataset. Now we're set with the permissions.

Next, we have to go back to the IAM & Admin page to generate a key for Datafold:
For Datafold, we use the recommended json format. After creating the key, it will be saved on your local machine
In the Project ID field, enter the BigQuery project ID. It can be found in the URL of your Google Developers Console:
In the Schema for temporary tables field, enter the project id and temporary table name in the following format Project_id.temp_table_name.
After setting permissions in your data source, move on to Configuration ->
Last modified 1mo ago
Copy link
On this page
Create a Service Account
Service Account Access and Permissions
Create a Temporary Dataset
Generate a Service Account Key