Skip to content

Commit 6a943fe

Browse files
committed
update pre-reqs
1 parent 41d6ddb commit 6a943fe

2 files changed

Lines changed: 17 additions & 0 deletions

File tree

BIGQUERY.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,3 +23,15 @@ This section covers connecting to BigQuery.
2323
* If an operation fails due to permissions, identify the type of operation and recommend the appropriate role. You can provide these links for assistance:
2424
* Granting Roles: https://cloud.google.com/iam/docs/grant-role-console
2525
* BigQuery Permissions: https://cloud.google.com/iam/docs/roles-permissions/bigquery
26+
27+
### 2. BigQuery AI/ML Skills
28+
These skills leverage BigQuery's built-in AI functions (`AI.*`) for tasks like text generation, classification, and semantic search.
29+
30+
**Important**: Standard SQL-based `AI.*` functions (executed via `execute_sql()`) are preferred over dedicated BigQuery tools for tasks like Forecasting and Anomaly Detection.
31+
32+
1. **Prerequisites**:
33+
* Ensure your BigQuery project has the **Vertex AI API** enabled.
34+
* A [Cloud Resource Connection](https://docs.cloud.google.com/bigquery/docs/create-cloud-resource-connection) must be established in BigQuery to use `AI.*` functions.
35+
36+
2. **Handle Permission Errors**:
37+
* The service account associated with the BigQuery connection requires the **Vertex AI User** (`roles/aiplatform.user`) and the **BigQuery Connection User** (`roles/bigquery.connectionUser`) role.

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,11 @@ Before you begin, ensure you have the following:
4747
- Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
4848
- IAM Permissions:
4949
- BigQuery User (`roles/bigquery.user`)
50+
- (Optional) To use BigQuery AI/ML skills
51+
- Ensure that Vertex AI API is enabled
52+
- IAM permissions:
53+
- BigQuery Connection User (`roles/bigquery.connectionUser`)
54+
- Vertex AI User (`roles/aiplatform.user`)
5055

5156
## Getting Started
5257

0 commit comments

Comments
 (0)