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.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/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 |
+------------+-------------------+-------------------+