AI_INDEXES 檢視表

INFORMATION_SCHEMA.AI_INDEXES 檢視表包含資料集中每個 AI 索引的一列。

所需權限

如要查看 AI 索引中繼資料,您必須具備索引資料表的 bigquery.tables.get 或 bigquery.tables.list Identity and Access Management (IAM) 權限。下列每個預先定義的 IAM 角色都至少包含其中一項權限:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/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: Google Cloud 專案的 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                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+