Vue AI_INDEXES
La vue INFORMATION_SCHEMA.AI_INDEXES contient une ligne pour chaque index d'IA d'un ensemble de données.
Autorisations requises
Pour afficher les métadonnées d'index d'IA, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.tables.get ou bigquery.tables.list sur la table contenant l'index. Chacun des rôles IAM prédéfinis suivants inclut au moins l'une de ces autorisations :
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/bigquery.user
Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.
Schéma
Lorsque vous interrogez la vue INFORMATION_SCHEMA.AI_INDEXES, les résultats de la requête contiennent une ligne pour chaque index d'IA d'un ensemble de données.
La vue INFORMATION_SCHEMA.AI_INDEXES présente le schéma suivant :
| Nom de la colonne | Type de données | Valeur |
|---|---|---|
index_catalog |
STRING |
Nom du projet qui contient l'ensemble de données. |
index_schema |
STRING |
Nom de l'ensemble de données contenant l'index d'IA. |
table_name |
STRING |
Nom de la table sur laquelle l'index d'IA est créé. |
index_name |
STRING |
Nom de l'index d'IA. |
index_status |
RECORD |
État de l'index IA, contenant index_state (STRING) et message (STRING). |
creation_time |
TIMESTAMP |
Heure de création de l'index d'IA. |
last_modification_time |
TIMESTAMP |
Heure de la dernière modification de la configuration d'index d'IA. |
disable_time |
TIMESTAMP |
Heure à laquelle l'index d'IA a été désactivé, ou NULL si l'index n'est pas désactivé. |
ddl |
STRING |
Instruction LDD utilisée pour créer l'index d'IA. |
coverage_percentage |
INTEGER |
Pourcentage approximatif de lignes de table indexées par l'index d'IA. |
unindexed_row_count |
INTEGER |
Nombre de lignes de la table qui ne sont pas encore indexées par l'index d'IA. |
total_logical_bytes |
INTEGER |
Nombre total d'octets logiques facturables utilisés par l'index d'IA. |
Champ d'application et syntaxe
Les requêtes exécutées sur cette vue doivent être associées à un qualificatif d'ensemble de données. Le tableau suivant explique le champ d'application de la région pour cette vue :
| Nom de la vue | Champ d'application de la ressource | Champ d'application de la région |
|---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES |
Niveau de l'ensemble de données | Emplacement d'un ensemble de données |
Remplacez les éléments suivants :
PROJECT_ID: ID de votre projet Google Cloud .DATASET_ID: ID de votre ensemble de données.
Exemple
La requête suivante affiche la couverture et la taille de stockage de tous les index d'IA dans 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;
Le résultat ressemble à ce qui suit :
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| 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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+