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 | +------------+------------+-------------------+------------------+