AI_INDEXES ビュー

INFORMATION_SCHEMA.AI_INDEXES ビューには、データセット内の AI インデックスごとに 1 行が表示されます。

必要な権限

AI インデックスのメタデータを表示するには、インデックスを含むテーブルに対する bigquery.tables.get または bigquery.tables.list の Identity and Access Management(IAM)権限が必要です。次に示す事前定義された各 IAM ロールには、これらのうち少なくとも 1 つの権限が含まれています。

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/bigquery.user

BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。

スキーマ

INFORMATION_SCHEMA.AI_INDEXES ビューにクエリを実行すると、データセット内の各 AI インデックスに関する情報が 1 行ずつ表示されるクエリ結果が返されます。

INFORMATION_SCHEMA.AI_INDEXES ビューのスキーマは次のとおりです。

列名 データ型 値
index_catalog STRING データセットを含むプロジェクトの名前。
index_schema STRING AI インデックスを含むデータセットの名前。
table_name STRING AI インデックスが作成されるテーブルの名前。
index_name STRING AI インデックスの名前。
index_status RECORD AI インデックスのステータス。index_state(STRING)と message(STRING)が含まれます。
creation_time TIMESTAMP AI インデックスが作成された時刻。
last_modification_time TIMESTAMP AI インデックス構成が最後に変更された時刻。
disable_time TIMESTAMP AI インデックスが無効になった時刻。インデックスが無効になっていない場合は NULL。
ddl STRING AI インデックスの作成に使用される DDL ステートメント。
coverage_percentage INTEGER AI インデックスによってインデックスに登録されているテーブル行のおおよその割合。
unindexed_row_count INTEGER AI インデックスによってまだインデックスに登録されていないテーブル内の行数。
total_logical_bytes INTEGER AI インデックスで使用される課金対象の論理バイトの合計。

スコープと構文

このビューに対するクエリでは、データセット修飾子を指定する必要があります。次の表に、このビューのリージョン スコープを示します。

ビュー名 リソース スコープ リージョン スコープ
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES データセット レベル データセットの場所

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

  • PROJECT_ID: 実際の Cloud de Confiance by S3NS プロジェクト ID。
  • DATASET_ID: データセットの ID

例

次のクエリは、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                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+