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.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/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 Cloud de Confiance by S3NS .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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+