Vue AI_INDEX_COLUMNS

La vue INFORMATION_SCHEMA.AI_INDEX_COLUMNS contient une ligne pour chaque colonne indexée par l'IA sur chaque table 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_INDEX_COLUMNS, les résultats de la requête contiennent une ligne pour chaque colonne indexée de chaque table d'un ensemble de données.

La vue INFORMATION_SCHEMA.AI_INDEX_COLUMNS 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_column_name STRING Nom d'une colonne indexée par l'IA. Pour les index d'IA créés avec AUTO COLUMNS, cette vue liste toutes les colonnes sélectionnées.

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_INDEX_COLUMNS 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 liste les colonnes indexées pour les index d'IA dans my_project.my_dataset :

SELECT
  table_name,
  index_name,
  index_column_name
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;

Le résultat ressemble à ce qui suit :

+------------+-------------------+-------------------+
| table_name | index_name        | index_column_name |
+------------+-------------------+-------------------+
| products   | products_ai_index | name              |
| products   | products_ai_index | description       |
| products   | products_ai_index | category          |
| products   | products_ai_index | review            |
+------------+-------------------+-------------------+