AI_INDEXES ビュー
INFORMATION_SCHEMA.AI_INDEXES ビューには、データセット内の AI インデックスごとに 1 行が表示されます。
必要な権限
AI インデックスのメタデータを表示するには、インデックスを含むテーブルに対する bigquery.tables.get または bigquery.tables.list の Identity and Access Management(IAM)権限が必要です。次に示す事前定義された各 IAM ロールには、これらのうち少なくとも 1 つの権限が含まれています。
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+