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.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/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 Cloud de Confiance by S3NS .
  • 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                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+