VECTOR_INDEX_COLUMNS 视图
对于数据集中每个表的每个矢量索引列,INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
视图都会包含一个与之相对应的行。
所需权限
如需查看矢量索引元数据,您需要对具有相应索引的表拥有 bigquery.tables.get
或 bigquery.tables.list
Identity and Access Management (IAM) 权限。以下每个预定义的 IAM 角色都至少包含以下权限之一:
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
视图时,数据集中的每个表上每个编入索引的列都会有一行包含在查询结果中。
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 | +------------+------------+-------------------+------------------+