Skip to main content

BigQuery

Connect a Google BigQuery dataset to DashX. Once installed, you can sync its tables into Resources and query them through the DashX API.

Prerequisites

Prerequisites

Before setting up the BigQuery integration, ensure you have:

  • An active DashX account
  • A Google Cloud project with billing enabled
  • The BigQuery API enabled on that project
  • A dataset you want to expose to DashX

Create a service account

BigQuery authenticates with a service account key.

  1. Open the Google Cloud Console and select your project
  2. Go to IAM & Admin > Service Accounts and click Create service account
  3. Give it a name (e.g. dashx-bigquery) and create it
  4. Grant it these roles:
    • BigQuery Data Viewer — read table data
    • BigQuery Job User — run queries
  5. Open the service account, go to the Keys tab
  6. Click Add key > Create new key, choose JSON, and download the file
warning

The downloaded JSON is a credential. Store it securely and do not commit it to source control.

Connect to DashX

  1. Log in to your DashX workspace
  2. Navigate to Settings > Integrations
  3. Click [+] to add a new integration and select BigQuery
  4. Choose the environments you want to enable it for
  5. Enter the configuration below and save

Configuration

FieldDescription
CredentialsThe full contents of the service account JSON key file. The project is read from the key.

Sync your tables

With the integration installed, open Data > Overview and choose Sync Database to read the schema and turn tables into resources. See Resources for the full flow.

tip

BigQuery bills by bytes scanned. Prefer partitioned and clustered tables, and grant access only to the datasets DashX actually needs.

Related: the Database Hub app.