Vista AI_INDEXES

La vista INFORMATION_SCHEMA.AI_INDEXES contiene una fila para cada índice de IA en un conjunto de datos.

Permisos necesarios

Para ver los metadatos del índice de IA, necesitas el permiso bigquery.tables.get o bigquery.tables.list de Identity and Access Management (IAM) en la tabla con el índice. Cada una de los siguientes roles predefinidos de IAM incluye, al menos, uno de estos permisos:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/bigquery.user

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.AI_INDEXES, los resultados de la consulta contienen una fila por cada índice de IA de un conjunto de datos.

La vista INFORMATION_SCHEMA.AI_INDEXES tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
index_catalog STRING El nombre del proyecto que contiene el conjunto de datos.
index_schema STRING Es el nombre del conjunto de datos que contiene el índice de IA.
table_name STRING Es el nombre de la tabla en la que se crea el índice de IA.
index_name STRING Es el nombre del índice de IA.
index_status RECORD Es el estado del índice de IA, que contiene index_state (STRING) y message (STRING).
creation_time TIMESTAMP Es la hora en la que se creó el índice de IA.
last_modification_time TIMESTAMP La última vez que se modificó la configuración del índice de IA.
disable_time TIMESTAMP Es la hora en la que se inhabilitó el índice de IA o NULL si el índice no está inhabilitado.
ddl STRING Es la declaración DDL que se usa para crear el índice de IA.
coverage_percentage INTEGER Es el porcentaje aproximado de filas de la tabla que se indexan con el índice de IA.
unindexed_row_count INTEGER Es la cantidad de filas de la tabla que aún no se indexaron con el índice de IA.
total_logical_bytes INTEGER La cantidad total de bytes lógicos facturables que usa el índice de IA.

Permiso y sintaxis

Las consultas realizadas a esta vista deben tener un calificador de conjunto de datos. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista Permiso del recurso Permiso de la región
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES Nivel de conjunto de datos Ubicación del conjunto de datos

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • DATASET_ID: Es el ID del conjunto de datos.

Ejemplo

En la siguiente consulta, se muestra la cobertura y el tamaño de almacenamiento de todos los índices de IA en my_project.my_dataset:

SELECT
  table_name,
  index_name,
  creation_time,
  coverage_percentage,
  unindexed_row_count,
  total_logical_bytes
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEXES;

El resultado es similar al siguiente:

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