Vista AI_INDEXES

La vista INFORMATION_SCHEMA.AI_INDEXES contiene una riga per ogni indice AI in un set di dati.

Autorizzazioni obbligatorie

Per visualizzare i metadati dell'indice AI, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.tables.get o bigquery.tables.list sulla tabella con l'indice. Ciascuno dei seguenti ruoli IAM predefiniti include almeno una di queste autorizzazioni:

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

Per saperne di più sulle autorizzazioni di BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.AI_INDEXES, i risultati della query contengono una riga per ogni indice AI in un set di dati.

La vista INFORMATION_SCHEMA.AI_INDEXES ha il seguente schema:

Nome colonna Tipo di dati Valore
index_catalog STRING Il nome del progetto che contiene il set di dati.
index_schema STRING Il nome del set di dati che contiene l'indice AI.
table_name STRING Il nome della tabella su cui viene creato l'indice AI.
index_name STRING Il nome dell'indice AI.
index_status RECORD Lo stato dell'indice AI, contenente index_state (STRING) e message (STRING).
creation_time TIMESTAMP La data e l'ora in cui è stato creato l'indice AI.
last_modification_time TIMESTAMP L'ultima volta che la configurazione dell'indice AI è stata modificata.
disable_time TIMESTAMP La data e l'ora in cui l'indice AI è stato disattivato o NULL se l'indice non è disattivato.
ddl STRING L'istruzione DDL utilizzata per creare l'indice AI.
coverage_percentage INTEGER La percentuale approssimativa di righe della tabella indicizzate dall'indice AI.
unindexed_row_count INTEGER Il numero di righe della tabella che non sono ancora state indicizzate dall'indice AI.
total_logical_bytes INTEGER Il numero totale di byte logici fatturabili utilizzati dall'indice AI.

Ambito e sintassi

Le query su questa vista devono avere un qualificatore del set di dati. La tabella seguente illustra l'ambito della regione per questa visualizzazione:

Visualizza nome Ambito risorsa Ambito della regione
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES Livello del set di dati Posizione del set di dati

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progetto Cloud de Confiance by S3NS .
  • DATASET_ID: l'ID del set di dati.

Esempio

La seguente query mostra la copertura e le dimensioni di archiviazione di tutti gli indici AI in 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;

Il risultato è simile al seguente:

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