AI インデックスを使用する

AI.SEARCH 関数を使用してデータをクエリできます。BigQuery は、列の選択、インデックスの最適化、継続的なメンテナンスを自動的に処理します。

このドキュメントでは、AI インデックスの作成、モニタリング、削除の方法と、インデックスに登録されたデータのクエリ方法について説明します。

ロールと権限

AI インデックスを使用するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

AI インデックスを作成する

標準の BigQuery テーブルに AI インデックスを作成するには、CREATE AI INDEX データ定義言語(DDL)ステートメントを使用します。インデックスに登録する列を指定することも、AUTO COLUMNS オプションを使用して BigQuery で候補列を自動的に選択することもできます。

AI インデックスの作成に関する制限事項

AI インデックスを作成する際には、次の制限が適用されます。

  • 最上位レベルの、繰り返しのない STRING 列のみがサポートされます。ARRAY<STRING>、STRUCT、JSON、ObjectRef、ネストされたフィールド、STRING 以外の列、疑似列はサポートされていません。
  • 1 つの AI インデックスに最大 50 個の列をインデックスに登録できます。
  • AI インデックスは、標準の BigQuery テーブルにのみ作成できます。ビュー、マテリアライズド ビュー、外部テーブル、BigLake テーブル、Apache Iceberg テーブル、テーブル スナップショットはサポートされていません。
  • クロスリージョン レプリカを含むデータセットに AI インデックスを作成することはできません。
  • CREATE AI INDEX を実行する場合、ベーステーブルには、オンデマンド プロジェクトの場合は最大 1,000,000 行、テーブルを含むプロジェクトに BACKGROUND 予約割り当てがある場合は最大 100,000,000 行を含めることができます。
  • AUTO COLUMNS は、CREATE AI INDEX ステートメントの実行時に列を選択します。後でテーブルに列を追加しても、自動的にインデックスに登録されることはありません。新しい列を含めるには、AI インデックスを削除して再作成します。
  • 各テーブルでサポートされる AI インデックスは 1 つだけです。AI インデックスを含むテーブルに、ベクトル インデックスや自動生成されたエンベディング列を含めることはできません。

制限事項の一覧については、AI インデックスの制限事項をご覧ください。

AUTO COLUMNS を使用して AI インデックスを作成する

AUTO COLUMNS を使用して AI インデックスを作成すると、BigQuery はテーブル スキーマを自動的にスキャンし、最大 50 個の対象列を選択します。AUTO COLUMNS を使用して AI インデックスを作成するには、CREATE AI INDEX DDL ステートメントを使用します。

  1. Cloud de Confiance コンソールで [BigQuery Studio] に移動します。

    [BigQuery Studio] に移動

  2. クエリエディタで、次の SQL ステートメントを実行します。

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

    次のように置き換えます。

    • INDEX_NAME: 作成する AI インデックスの名前。インデックスは常にベーステーブルと同じプロジェクトとデータセットに作成されるため、インデックス名にプロジェクトまたはデータセットを指定する必要はありません。インデックス名は、テーブルのすべてのインデックスで一意である必要があります。
    • DATASET_NAME: テーブルを含むデータセットの名前。
    • TABLE_NAME: インデックスに登録する標準テーブルの名前。

次の例では、mydataset.products に AUTO COLUMNS を使用して AI インデックスを作成します。

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

特定の列に AI インデックスを作成する

AI インデックスは、単一の列または特定の列のサブセットに作成できます。たとえば、テーブルに 50 を超える有効な列がある場合や、不透明な ID、UUID、ハッシュ、未加工ログなどの機密性の高い列やノイズの多い列を除外する場合です。複数の列を指定する場合は、タイトル列や名前列など、最も情報量の多い列を列リストの最初に配置します。

次の例では、mydataset.products の name 列と description 列にのみ AI インデックスが作成されます。

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

次の例では、mydataset.products の description 列にのみ AI インデックスが作成されます。

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

AI インデックスを使用してテーブルを検索する

AI インデックスを持つテーブルをクエリするには、AI.SEARCH 関数を使用します。テーブルに AI インデックスがある場合、必要な引数は base_table または base_table_query と query_value の 2 つだけです。

インデックスに登録されたすべての列を検索する

AI インデックスの対象となるすべての列を検索するには、column_to_search 引数を省略し、ベーステーブルとクエリ文字列を渡します。

次の例では、AI インデックスの対象となる mydataset.products のすべての列を検索します。

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;

AI インデックスのステータスをモニタリングする

次の INFORMATION_SCHEMA ビューをクエリすることで、AI インデックスのステータス、カバレッジ、インデックスに登録された列をモニタリングできます。

  • INFORMATION_SCHEMA.AI_INDEXES: データセット内の各 AI インデックスに関するメタデータが含まれます。
  • INFORMATION_SCHEMA.AI_INDEX_COLUMNS: データセット内の各 AI インデックスの対象となる列を一覧表示します。これにより、AUTO COLUMNS の使用時に選択された列を確認できます。
  • INFORMATION_SCHEMA.JOBS: AI インデックスの作成とメンテナンスに使用されるバックグラウンド ジョブなど、バックグラウンド ジョブに関する情報が含まれます。

AI インデックスの例

次のクエリは、my_project.my_dataset 内のすべての AI インデックスのカバレッジとストレージ サイズを示しています。

SELECT
  table_name,
  index_name,
  creation_time,
  coverage_percentage,
  unindexed_row_count,
  total_logical_bytes
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEXES;

次のような結果になります。

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

AI インデックス列の例

次のクエリは、my_project.my_dataset の AI インデックスのインデックス付き列を一覧表示します。

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

次のような結果になります。

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

バックグラウンド ジョブの費用を追跡する例

テーブルのバックグラウンド AI インデックス データ処理ジョブの total_slot_ms 値と total_bytes_billed 値を追跡するには、gc_ の job_id 接頭辞を持つジョブの INFORMATION_SCHEMA.JOBS ビューをクエリします。

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;

次のように置き換えます。

  • REGION: テーブルを含むデータセット リージョン(例: us)。
  • PROJECT_ID: テーブルを含むプロジェクトの ID。
  • DATASET_ID: テーブルを含むデータセットの名前。
  • TABLE: AI インデックスを含むテーブルの名前。

AI インデックスを削除する

インデックス登録されたテーブルを削除すると、その AI インデックスも削除されます。テーブルを削除せずに AI インデックスを削除するには、DROP AI INDEX DDL ステートメントを使用します。

DROP AI INDEX IF EXISTS INDEX_NAME ON DATASET_NAME.TABLE_NAME;

次のように置き換えます。

  • INDEX_NAME: 削除する AI インデックスの名前。
  • DATASET_NAME: テーブルを含むデータセットの名前。
  • TABLE_NAME: AI インデックスを含むテーブルの名前。

次のステップ