Utiliser les index d'IA

Vous pouvez utiliser la fonction AI.SEARCH pour interroger vos données, tandis que BigQuery gère automatiquement la sélection des colonnes, l'optimisation de l'index et la maintenance continue.

Ce document explique comment créer, surveiller et supprimer des index d'IA, et comment interroger vos données indexées.

Rôles et autorisations

Pour obtenir les autorisations nécessaires pour utiliser les index d'IA, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un index d'IA

Vous pouvez créer un index d'IA sur une table BigQuery standard à l'aide de l'instruction de langage de définition de données (LDD) CREATE AI INDEX. Vous pouvez spécifier les colonnes à indexer ou laisser BigQuery sélectionner automatiquement les colonnes candidates à l'aide de l'option AUTO COLUMNS.

Limites de la création d'index IA

Lorsque vous créez un index d'IA, les limites suivantes s'appliquent :

  • Seules les colonnes STRING uniques de premier niveau sont acceptées. ARRAY<STRING>, STRUCT, JSON, ObjectRef, les champs imbriqués, les colonnes non-STRING et les pseudo-colonnes ne sont pas acceptés.
  • Vous pouvez indexer jusqu'à 50 colonnes dans un seul index d'IA.
  • Vous ne pouvez créer un index d'IA que sur une table BigQuery standard. Les vues, les vues matérialisées, les tables externes, les tables BigLake, les tables Apache Iceberg et les instantanés de table ne sont pas acceptés.
  • Vous ne pouvez pas créer d'index d'IA dans des ensembles de données comportant des instances répliquées interrégionales.
  • Lorsque vous exécutez CREATE AI INDEX, la table de base peut comporter au maximum 1 000 000 de lignes pour les projets à la demande, ou jusqu'à 100 000 000 de lignes si le projet contenant la table dispose d'une attribution de réservation BACKGROUND.
  • AUTO COLUMNS sélectionne les colonnes lors de l'exécution de l'instruction CREATE AI INDEX. Si vous ajoutez des colonnes à la table ultérieurement, elles ne sont pas automatiquement indexées. Pour inclure de nouvelles colonnes, supprimez l'index d'IA et recréez-le.
  • Chaque table n'accepte qu'un seul index d'IA. Une table avec un index d'IA ne peut pas non plus comporter d'index vectoriel ni de colonne d'embeddings générée automatiquement.

Pour obtenir la liste complète des limites, consultez Limites des index d'IA.

Créer un index d'IA avec AUTO COLUMNS

Lorsque vous créez un index d'IA avec AUTO COLUMNS, BigQuery analyse automatiquement le schéma de la table et sélectionne jusqu'à 50 colonnes éligibles. Pour créer un index d'IA avec AUTO COLUMNS, utilisez l'instruction LDD CREATE AI INDEX :

  1. Accédez à BigQuery Studio dans la console Cloud de Confiance .

    Accéder à BigQuery Studio

  2. Dans l'éditeur de requête, exécutez l'instruction SQL suivante :

    CREATE AI INDEX INDEX_NAME
    ON DATASET_NAME.TABLE_NAME(AUTO COLUMNS);

    Remplacez les éléments suivants :

    • INDEX_NAME : nom de l'index d'IA que vous créez. Étant donné que l'index est toujours créé dans le même projet et le même ensemble de données que la table de base, vous n'avez pas besoin de spécifier le projet ni l'ensemble de données dans le nom de l'index. Le nom de l'index doit être unique parmi tous les index de la table.
    • DATASET_NAME : nom de l'ensemble de données contenant la table.
    • TABLE_NAME : nom de la table standard à indexer.

Dans l'exemple suivant, un index d'IA est créé avec AUTO COLUMNS sur mydataset.products :

CREATE AI INDEX products_ai_index
ON mydataset.products(AUTO COLUMNS);

Créer un index IA sur des colonnes spécifiques

Vous pouvez créer un index IA sur une seule colonne ou sur un sous-ensemble spécifique de colonnes. Par exemple, lorsque votre table comporte plus de 50 colonnes éligibles, ou lorsque vous souhaitez exclure des colonnes sensibles ou à bruit élevé, telles que des ID opaques, des UUID, des hachages ou des journaux bruts. Si vous spécifiez plusieurs colonnes, placez les colonnes les plus informatives, telles qu'une colonne de titre ou de nom, en premier dans la liste des colonnes.

Dans l'exemple suivant, un index d'IA n'est créé que sur les colonnes name et description de mydataset.products :

CREATE AI INDEX products_ai_index
ON mydataset.products(name, description);

Dans l'exemple suivant, un index d'IA n'est créé que sur la colonne description de mydataset.products :

CREATE AI INDEX products_ai_index
ON mydataset.products(description);

Effectuer une recherche dans une table avec un index d'IA

Vous pouvez interroger une table dotée d'un index d'IA à l'aide de la fonction AI.SEARCH. Lorsqu'une table comporte un index d'IA, seuls deux arguments sont requis : base_table ou base_table_query, et query_value.

Rechercher dans toutes les colonnes indexées

Pour effectuer une recherche dans toutes les colonnes couvertes par l'index d'IA, omettez l'argument column_to_search, puis transmettez la table de base et la chaîne de requête.

L'exemple suivant recherche toutes les colonnes de mydataset.products couvertes par l'index d'IA :

SELECT
  base.id,
  base.name,
  base.description,
  distance
FROM
  AI.SEARCH(
    TABLE mydataset.products,
    'shoes that keep your feet dry in the rain',
    top_k => 5)
ORDER BY distance;

Surveiller l'état des index d'IA

Vous pouvez surveiller l'état, la couverture et les colonnes indexées de vos index d'IA en interrogeant les vues INFORMATION_SCHEMA suivantes :

  • INFORMATION_SCHEMA.AI_INDEXES : contient des métadonnées sur chaque index d'IA d'un ensemble de données.
  • INFORMATION_SCHEMA.AI_INDEX_COLUMNS : liste les colonnes couvertes par chaque index d'IA dans un ensemble de données, ce qui vous permet de vérifier quelles colonnes ont été sélectionnées lors de l'utilisation de AUTO COLUMNS.
  • INFORMATION_SCHEMA.JOBS : contient des informations sur les jobs en arrière-plan, y compris ceux utilisés pour créer et gérer les index d'IA.

Exemple d'index d'IA

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

Exemple de colonnes d'index IA

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

Exemple de suivi des coûts des jobs en arrière-plan

Pour suivre les valeurs total_slot_ms et total_bytes_billed des jobs de traitement des données d'index d'IA en arrière-plan sur une table, interrogez la vue INFORMATION_SCHEMA.JOBS pour les jobs avec un préfixe job_id de gc_ :

SELECT
  job_id,
  creation_time,
  reservation_id,
  total_slot_ms,
  total_bytes_processed,
  total_bytes_billed
FROM
  `region-REGION`.INFORMATION_SCHEMA.JOBS j
WHERE
  EXISTS (
    SELECT 1
    FROM UNNEST(j.referenced_tables) t
    WHERE
      j.project_id = 'PROJECT_ID'
      AND t.dataset_id = 'DATASET_ID'
      AND t.table_id = 'TABLE'
  )
  AND STARTS_WITH(job_id, 'gc_')
ORDER BY
  j.creation_time DESC;

Remplacez les éléments suivants :

  • REGION : région de l'ensemble de données contenant votre table, par exemple "us".
  • PROJECT_ID : ID du projet contenant votre table.
  • DATASET_ID : nom de l'ensemble de données contenant votre table.
  • TABLE : nom de la table contenant l'index d'IA.

Supprimer un index d'IA

Lorsque vous supprimez une table indexée, son index d'IA est également supprimé. Pour supprimer un index d'IA sans supprimer la table, utilisez l'instruction LDD DROP AI INDEX :

DROP AI INDEX IF EXISTS INDEX_NAME ON DATASET_NAME.TABLE_NAME;

Remplacez les éléments suivants :

  • INDEX_NAME : nom de l'index d'IA que vous supprimez.
  • DATASET_NAME : nom de l'ensemble de données contenant la table.
  • TABLE_NAME : nom de la table contenant l'index d'IA.

Étapes suivantes