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.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/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 Google Cloud .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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+