使用 AI 索引
您可以使用 AI.SEARCH 函式查詢資料,BigQuery 會自動處理資料欄選取、索引最佳化和持續維護作業。
本文說明如何建立、監控及刪除 AI 索引,以及如何查詢已建立索引的資料。
角色和權限
如要取得使用 AI 索引所需的權限,請要求管理員在專案中授予您下列 IAM 角色:
-
建立或捨棄 AI 索引:BigQuery 資料擁有者 (
roles/bigquery.dataOwner) -
查詢資料表:
- BigQuery 資料檢視者 (
roles/bigquery.dataViewer) - BigQuery 工作使用者 (
roles/bigquery.jobUser)
- BigQuery 資料檢視者 (
-
查看 AI 索引中繼資料:BigQuery 資料檢視者 (
roles/bigquery.dataViewer)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
建立 AI 索引
您可以使用 CREATE AI INDEX 資料定義語言 (DDL) 陳述式,在標準 BigQuery 資料表上建立 AI 索引。您可以指定要建立索引的資料欄,也可以使用 AUTO COLUMNS 選項,讓 BigQuery 自動選取候選資料欄。
建立 AI 索引的限制
建立 AI 索引時,須遵守下列限制:
- 僅支援頂層、非重複的 STRING 資料欄。不支援
ARRAY<STRING>、STRUCT、JSON、ObjectRef、巢狀欄位、非STRING資料欄和虛擬資料欄。 - 單一 AI 索引最多可為 50 個資料欄建立索引。
- 您只能在標準 BigQuery 資料表建立 AI 索引。不支援檢視表、materialized view、外部資料表、BigLake 資料表、Apache Iceberg 資料表和資料表快照。
- 您無法在具有跨區域副本的資料集中建立 AI 索引。
- 執行
CREATE AI INDEX時,基礎資料表最多可有 1,000,000 個資料列 (適用於隨選專案),如果包含資料表的專案有BACKGROUND預留項目指派作業,則最多可有 100,000,000 個資料列。 AUTO COLUMNS會在CREATE AI INDEX陳述式執行時選取資料欄。如果之後在資料表中新增資料欄,系統不會自動建立索引。如要加入新資料欄,請捨棄 AI 索引並重新建立。- 每個資料表最多支援一個 AI 索引。含有 AI 索引的資料表,不能同時有向量索引或自動產生的嵌入欄。
如需完整限制清單,請參閱「AI 索引限制」。
使用 AUTO COLUMNS 建立 AI 索引
使用 AUTO COLUMNS 建立 AI 索引時,BigQuery 會自動掃描資料表結構定義,並選取最多 50 個符合條件的資料欄。如要使用 AUTO COLUMNS 建立 AI 索引,請使用 CREATE AI INDEX DDL 陳述式:
前往 Cloud de Confiance 控制台的「BigQuery Studio」。
在查詢編輯器中執行下列 SQL 陳述式:
CREATE AI INDEX INDEX_NAME ON DATASET_NAME.TABLE_NAME(AUTO COLUMNS);
更改下列內容:
INDEX_NAME:要建立的 AI 索引名稱。由於索引一律建立在與基礎資料表相同的專案和資料集中,因此您不需要在索引名稱中指定專案或資料集。索引名稱在資料表的所有索引中不得重複。DATASET_NAME:資料表所在資料集的名稱。TABLE_NAME:要建立索引的標準資料表名稱。
在以下範例中,系統會使用 mydataset.products 上的 AUTO COLUMNS 建立 AI 索引:
CREATE AI INDEX products_ai_index ON mydataset.products(AUTO COLUMNS);
為特定資料欄建立 AI 索引
您可以在單一資料欄或特定資料欄子集上建立 AI 索引。舉例來說,如果資料表有超過 50 個符合資格的資料欄,或您想排除機密或高雜訊的資料欄 (例如不透明 ID、UUID、雜湊或原始記錄),如果指定多個資料欄,請將最能提供資訊的資料欄 (例如標題或名稱欄) 放在資料欄清單的第一個位置。
在下列範例中,AI 索引只會建立在 mydataset.products 的 name 和 description 欄:
CREATE AI INDEX products_ai_index ON mydataset.products(name, description);
在以下範例中,系統只會在 mydataset.products 的 description 資料欄建立 AI 索引:
CREATE AI INDEX products_ai_index ON mydataset.products(description);
使用 AI 索引搜尋資料表
您可以使用 AI.SEARCH 函式,查詢含有 AI 索引的資料表。如果資料表有 AI 索引,則只需要兩個引數:base_table 或 base_table_query,以及 query_value。
搜尋所有已建立索引的資料欄
如要搜尋 AI 索引涵蓋的所有資料欄,請省略 column_to_search 引數,並傳遞基礎資料表和查詢字串。
以下範例會搜尋 mydataset.products 中 AI 索引涵蓋的所有資料欄:
SELECT base.id, base.name, base.description, distance FROM AI.SEARCH( TABLE mydataset.products, 'shoes that keep your feet dry in the rain', top_k => 5) ORDER BY distance;
監控 AI 索引的狀態
您可以查詢下列 INFORMATION_SCHEMA 檢視表,監控 AI 索引的狀態、涵蓋率和已建立索引的資料欄:
INFORMATION_SCHEMA.AI_INDEXES:包含資料集中各個 AI 索引的中繼資料。INFORMATION_SCHEMA.AI_INDEX_COLUMNS:列出資料集中每個 AI 索引涵蓋的資料欄,方便您確認使用AUTO COLUMNS時選取了哪些資料欄。INFORMATION_SCHEMA.JOBS:包含背景工作的相關資訊,包括用於建立及維護 AI 索引的背景工作。
AI 索引範例
下列查詢會顯示 my_project.my_dataset 中所有 AI 索引的涵蓋率和儲存空間大小:
SELECT table_name, index_name, creation_time, coverage_percentage, unindexed_row_count, total_logical_bytes FROM my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEXES;
結果大致如下:
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| table_name | index_name | creation_time | coverage_percentage | unindexed_row_count | total_logical_bytes |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| products | products_ai_index | 2026-10-01 18:02:11 | 100 | 0 | 25344 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
AI 索引資料欄範例
下列查詢會列出 my_project.my_dataset 中 AI 索引的索引資料欄:
SELECT table_name, index_name, index_column_name FROM my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;
結果大致如下:
+------------+-------------------+-------------------+
| table_name | index_name | index_column_name |
+------------+-------------------+-------------------+
| products | products_ai_index | name |
| products | products_ai_index | description |
| products | products_ai_index | category |
| products | products_ai_index | review |
+------------+-------------------+-------------------+
追蹤背景工作費用範例
如要追蹤資料表上背景 AI 索引資料處理工作的 total_slot_ms 和 total_bytes_billed 值,請查詢 INFORMATION_SCHEMA.JOBS 檢視表,找出 job_id 前置字元為 gc_ 的工作:
SELECT job_id, creation_time, reservation_id, total_slot_ms, total_bytes_processed, total_bytes_billed FROM `region-REGION`.INFORMATION_SCHEMA.JOBS j WHERE EXISTS ( SELECT 1 FROM UNNEST(j.referenced_tables) t WHERE j.project_id = 'PROJECT_ID' AND t.dataset_id = 'DATASET_ID' AND t.table_id = 'TABLE' ) AND STARTS_WITH(job_id, 'gc_') ORDER BY j.creation_time DESC;
更改下列內容:
REGION:資料表所在的資料集區域,例如 us。PROJECT_ID:資料表所在專案的 ID。DATASET_ID:資料表所在的資料集名稱。TABLE:含有 AI 索引的資料表名稱。
刪除 AI 索引
刪除已建立索引的資料表時,其 AI 索引也會一併刪除。如要刪除 AI 索引,但不刪除資料表,請使用 DROP AI INDEX DDL 陳述式:
DROP AI INDEX IF EXISTS INDEX_NAME ON DATASET_NAME.TABLE_NAME;
更改下列內容:
INDEX_NAME:要刪除的 AI 索引名稱。DATASET_NAME:資料表所在資料集的名稱。TABLE_NAME:含有 AI 索引的資料表名稱。
後續步驟
- 進一步瞭解
AI.SEARCH函式。 - 瞭解 BigQuery 中的嵌入。