AI_INDEX_COLUMNS ビュー

INFORMATION_SCHEMA.AI_INDEX_COLUMNS ビューには、データセット内の各テーブルの 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_INDEX_COLUMNS ビューにクエリを実行すると、クエリ結果として、データセット内の各テーブルのインデックス付き列ごとに 1 行が表示されます。

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

列名 データ型 値
index_catalog STRING データセットを含むプロジェクトの名前。
index_schema STRING AI インデックスを含むデータセットの名前。
table_name STRING AI インデックスが作成されるテーブルの名前。
index_name STRING AI インデックスの名前。
index_column_name STRING AI インデックス付き列の名前。AUTO COLUMNS で作成された AI インデックスの場合、このビューには選択されたすべての列が一覧表示されます。

スコープと構文

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

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

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

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

例

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