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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+