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