VECTOR_INDEX_COLUMNS 檢視表

INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS 檢視畫面會針對資料集中每個資料表的每個向量索引欄，分別列出一個資料列。

所需權限

如要查看向量索引中繼資料，您必須在含有索引的資料表上具備 bigquery.tables.get 或 bigquery.tables.list 身分與存取權管理 (IAM) 權限。以下每個預先定義的 IAM 角色都包含下列至少一項權限：

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/bigquery.user

如要進一步瞭解 BigQuery 權限，請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS 檢視表時，資料集中每個資料表的每個已編入索引的資料欄，在查詢結果中都會有一個資料列。

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     | embeddings        | embeddings       |
| table2     | indexb     | vectors           | vectors          |
| table3     | indexc     | vectors           | vectors          |
+------------+------------+-------------------+------------------+