Skip to content

Commit 517890a

Browse files
spicyfalafelclaude
andcommitted
docs: add warning about dataset/connection/CloudSQL location constraint for federated queries
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 774995f commit 517890a

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

docs/tutorials/subscriptions-tutorials/bigquery-aidboxtopicdestination.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -394,8 +394,12 @@ BigQuery connects to Cloud SQL, runs the `SELECT` against the materialized ViewD
394394

395395
The `location` must match the region where the BigQuery Connection was created.
396396

397+
{% hint style="warning" %}
398+
**Location constraint:** The BigQuery dataset, the BigQuery Connection, and the Cloud SQL instance must all be in the same region (e.g., `us-east1`). If your dataset is in a multi-region location like `US`, federated queries will fail with "Dataset not found in location". You need to create the dataset in the same regional location as your Cloud SQL instance.
399+
{% endhint %}
400+
397401
{% hint style="info" %}
398-
**When to use this:** The default Storage Write API path works well for datasets up to ~100K rows. For larger datasets (1M+ rows), federated query is significantly faster because it eliminates the single-threaded JVM bottleneck. The trade-off is the one-time setup of a BigQuery Connection.
402+
**When to use this:** The default Storage Write API path works well for datasets up to ~100K rows. For larger datasets (1M+ rows), federated query is significantly faster because it eliminates the single-threaded JVM bottleneck. The trade-off is the one-time setup of a BigQuery Connection and the regional location constraint.
399403
{% endhint %}
400404

401405
{% hint style="warning" %}

0 commit comments

Comments
 (0)