VECTOR_INDEX_COLUMNS ビュー

この機能に関するフィードバックを提供したり、サポートをリクエストしたりするには、bq-vector-search@google.com までメールをお送りください。

INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS ビューには、データセット内の各テーブルのベクター インデックス列ごとに 1 行が表示されます。

必要な権限

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

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

列名 データ型
index_catalog STRING データセットを含むプロジェクトの名前。
index_schema STRING ベクター インデックスを含むデータセットの名前。
table_name STRING ベクター インデックスが作成されるテーブルの名前。
index_name STRING ベクター インデックスの名前。
index_column_name STRING インデックス列の名前。
index_field_path STRING 拡張されたインデックス付きフィールドのフルパス(列名から始まる)。フィールドはピリオドで区切る。

スコープと構文

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

ビュー名 リソース スコープ リージョン スコープ
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS データセット レベル データセットのロケーション

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

  • 省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
  • DATASET_ID: データセットの ID。詳しくは、データセット修飾子をご覧ください。

-- Returns metadata for vector indexes in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;

次のクエリは、ベクター インデックスが付いている列の情報を抽出します。

SELECT table_name, index_name, index_column_name, index_field_path
FROM my_project.dataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;

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

+------------+------------+-------------------+------------------+
| table_name | index_name | index_column_name | index_field_path |
+------------+------------+-------------------+------------------+
| table1     | indexa     | a                 | a                |
| table2     | indexb     | b                 | b                |
| table3     | indexc     | c                 | c                |
+------------+------------+-------------------+------------------+