Visualização AI_INDEXES
A visualização INFORMATION_SCHEMA.AI_INDEXES contém uma linha para cada índice de IA em um conjunto de dados.
Permissões necessárias
Para ver os metadados do índice de IA, é preciso ter a permissão bigquery.tables.get ou bigquery.tables.list do Identity and Access Management (IAM) na tabela com o índice. Cada um dos seguintes papéis predefinidos
do IAM inclui pelo menos uma destas permissões:
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/bigquery.user
Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.
Esquema
Quando você consulta a visualização INFORMATION_SCHEMA.AI_INDEXES, os resultados da consulta contêm uma linha para cada índice de IA em um conjunto de dados.
A visualização INFORMATION_SCHEMA.AI_INDEXES tem o seguinte esquema:
| Nome da coluna | Tipo de dados | Valor |
|---|---|---|
index_catalog |
STRING |
Nome do projeto que contém o conjunto de dados. |
index_schema |
STRING |
O nome do conjunto de dados que contém o índice de IA. |
table_name |
STRING |
O nome da tabela em que o índice de IA é criado. |
index_name |
STRING |
O nome do índice de IA. |
index_status |
RECORD |
O status do índice de IA, que contém index_state
(STRING) e message (STRING). |
creation_time |
TIMESTAMP |
A hora em que o índice de IA foi criado. |
last_modification_time |
TIMESTAMP |
A última vez que a configuração do índice de IA foi modificada. |
disable_time |
TIMESTAMP |
O horário em que o índice de IA foi desativado ou NULL se o índice não estiver desativado. |
ddl |
STRING |
A instrução DDL usada para criar o índice de IA. |
coverage_percentage |
INTEGER |
A porcentagem aproximada de linhas da tabela que são indexadas pelo índice de IA. |
unindexed_row_count |
INTEGER |
O número de linhas na tabela que ainda não foram indexadas pelo índice de IA. |
total_logical_bytes |
INTEGER |
O total de bytes lógicos faturáveis usados pelo índice de IA. |
Escopo e sintaxe
As consultas nesta visualização precisam ter um qualificador de conjunto de dados. A tabela a seguir explica o escopo da região dessa visualização:
| Mostrar nome | Escopo do recurso | Escopo da região |
|---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES |
Nível do conjunto de dados | Local do conjunto de dados |
Substitua:
PROJECT_ID: o ID do seu projeto do Cloud de Confiance by S3NS .DATASET_ID: ID do conjunto de dados.
Exemplo
A consulta a seguir mostra a cobertura e o tamanho de armazenamento de todos os índices de IA em
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;
O resultado será semelhante ao seguinte:
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| 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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+