> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BigQuery

> Connect BonData to Google BigQuery to sync your data warehouse tables

Google BigQuery is a serverless, highly scalable data warehouse designed for fast SQL analytics over large datasets. With BonData, you can connect to your BigQuery project to read, enrich, and act on your warehouse data within Agent workflows.

## BigQuery Service Account Setup

Follow these steps to create a service account for BonData.

### Step 1: Create a Service Account

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Select your project (or create one)
3. Navigate to **IAM & Admin** → **Service Accounts**
4. Click **Create Service Account**
5. Enter a name (e.g., `bondata-bigquery`)
6. Click **Create and Continue**

### Step 2: Grant Permissions

Assign these roles to the service account:

* **BigQuery Data Viewer** - to read table data
* **BigQuery Job User** - to run queries
* **BigQuery Metadata Viewer** - to list datasets and tables

Click **Continue** → **Done**

### Step 3: Create a Key

1. Click on your new service account
2. Go to the **Keys** tab
3. Click **Add Key** → **Create new key**
4. Select **JSON** format
5. Click **Create** - the key file will download

### Step 4: Upload the Key

Upload or paste the downloaded JSON key file in BonData.

## Required Fields

| Field                | Description                                            |
| -------------------- | ------------------------------------------------------ |
| Service Account JSON | The JSON key file downloaded from Google Cloud Console |