Skip to Content
DestinationsBigQuerySetup Instructions

Set Up Google BigQuery

Connect a project and dataset with managed or customer-owned service-account access.

Last reviewed September 15, 2026

Prerequisites

  • A Google Cloud project with BigQuery enabled
  • A dataset in the necessary location
  • Permission to grant IAM access
  • A clear decision about whether Vendo needs read access, write access, or both

Connect with Vendo’s Service Account

  1. In Vendo, open Data → Integrations → Apps and add Google BigQuery.
  2. Choose Vendo Service Account.
  3. Enter the GCP project ID.
  4. Copy the service-account address that the form shows.
  5. In Google Cloud IAM, grant that principal the roles that the form shows for the agreed scope.
  6. Go back to Vendo and select Load Datasets.
  7. Choose the correct dataset and verify access.
  8. Save the app.

The form checks read access and write access separately. A failed write check can be acceptable for a source that only reads data. But it stops workflows that must create or update tables.

Connect with Your Own Service Account

  1. In Google Cloud, create a dedicated service account for Vendo.
  2. Grant the minimum roles on the correct project and dataset.
  3. Create a JSON key only if your policy permits long-lived keys.
  4. In the Vendo BigQuery form, choose Bring your own service account.
  5. Paste the complete JSON into Service Account JSON.
  6. Enter the project and dataset IDs.
  7. Save the app and run a small test sync.

Delete all local copies of the downloaded key after you store it in the approved secret system.

Verify End to End

For a source, run a schema discovery or a limited query, and compare the result with BigQuery. For a destination, send a small batch that you can identify. Then verify the target table, row count, schema, timestamps, and identifiers.

Troubleshooting

SymptomCheck
No datasets foundProject ID, managed principal, dataset IAM, and dataset location
Read deniedDataset viewer access and BigQuery job permission
Write deniedDataset editor access for the selected dataset
Own key rejectedValid service-account JSON with project_id, private_key, and client_email
Sync runs but data is wrongSource selection, stream, mapping, schedule, and destination table
Need help?

When you contact support, give your workspace, the source or destination name, the job ID and the first error message.

support@vendodata.com
Last updated on