Skip to main content

How to set up BigQuery

Updated this week

Setup takes about 15 minutes.

Introduction

Use this connector to allow Foundational to scan BigQuery metadata and determine lineage and data quality.

To make the connection, you need to:

  • Create a Google Cloud service account and assign roles

  • Create and download a JSON service account key

  • Upload the key to Foundational to make the connection


Prerequisites

Ensure you have:

  • Google Cloud administrator access for parts of this setup

  • Access to the Google Cloud project that contains your BigQuery resources

  • Added Foundational IP addresses to the allowlist, see the article Allowing IP access to Foundational.


Access permissions

The permissions you assign to Foundational enable it to:

  • Read BigQuery metadata

  • Determine lineage

  • Optional: If you want data monitoring features such as NULL checks, grant Foundational access to read underlying data.


Create a service account and assign roles

  1. In Google Cloud, open the IAM & Admin page and select Service Accounts.

  2. Select the relevant Google Cloud project and click Create service account.

  3. The Create service account screen opens.​


    Enter the details:

    • Service account name: foundational-reader

    • Service account ID: foundational-reader

  4. On the same screen, click Create and continue.

  5. The Grant this service account access to project screen opens.


    Add the roles:

  6. (Optional) Add additional roles: Assign two additional roles only if you want Foundational to have access to advanced data monitoring features, such as NULL checks:

    • BigQuery Data Viewer

    • BigQuery Job User

  7. To save, click Done.


Create a service account key

  1. From the Service Accounts page, select the newly created service account.

  2. At the next screen, select the Keys tab (#1) and then open the ADD KEY dropdown (#2).​

  3. Select Create new key.

  4. Select JSON as the key type and click Create.​

  5. Download the key and save it. You’ll need it to set up the connection.


Connect Foundational to BigQuery

  1. In Foundational, open the Connectors & Integrations page.

  2. In Warehouses, select the BigQuery card and click Connect.

  3. Click Add Project.

  4. The initial setup screen opens. Click Start Setup.

    ​​

  5. The Set Up New Connection screen opens.

  6. Upload the JSON file you saved earlier.

  7. Click Next.

  8. The final setup screen opens. To complete the connection, click Save.​


That’s it. Foundational is now connected to BigQuery.

Did this answer your question?