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.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/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                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+