AI_INDEXES 檢視表
INFORMATION_SCHEMA.AI_INDEXES 檢視表包含資料集中每個 AI 索引的一列。
所需權限
如要查看 AI 索引中繼資料,您必須具備索引資料表的 bigquery.tables.get 或 bigquery.tables.list Identity and Access Management (IAM) 權限。下列每個預先定義的 IAM 角色都至少包含其中一項權限:
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/bigquery.user
如要進一步瞭解 BigQuery 權限,請參閱「使用 IAM 控管存取權」。
結構定義
查詢 INFORMATION_SCHEMA.AI_INDEXES 檢視表時,查詢結果會為資料集中的每個 AI 索引顯示一列。
INFORMATION_SCHEMA.AI_INDEXES 檢視表具有下列結構定義:
| 資料欄名稱 | 資料類型 | 值 |
|---|---|---|
index_catalog |
STRING |
資料集所屬專案的名稱。 |
index_schema |
STRING |
含有 AI 索引的資料集名稱。 |
table_name |
STRING |
建立 AI 索引的資料表名稱。 |
index_name |
STRING |
AI 索引的名稱。 |
index_status |
RECORD |
AI 索引的狀態,包含 index_state (STRING) 和 message (STRING)。 |
creation_time |
TIMESTAMP |
建立 AI 索引的時間。 |
last_modification_time |
TIMESTAMP |
上次修改 AI 索引設定的時間。 |
disable_time |
TIMESTAMP |
停用 AI 索引的時間。如果索引未停用,則為 NULL。 |
ddl |
STRING |
用於建立 AI 索引的 DDL 陳述式。 |
coverage_percentage |
INTEGER |
AI 索引建立索引的資料表資料列約略百分比。 |
unindexed_row_count |
INTEGER |
資料表中尚未由 AI 索引建立索引的資料列數。 |
total_logical_bytes |
INTEGER |
AI 索引使用的可計費邏輯位元組總數。 |
範圍和語法
對這個檢視表執行的查詢必須包含資料集限定詞。下表說明這個檢視畫面的區域範圍:
| 檢視表名稱 | 資源範圍 | 區域範圍 |
|---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES |
資料集層級 | 資料集位置 |
更改下列內容:
PROJECT_ID: Cloud de Confiance by S3NS 專案的 ID。DATASET_ID:資料集的 ID。
範例
下列查詢會顯示 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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+