Visualização VECTOR_INDEX_COLUMNS
Para enviar feedback ou solicitar suporte para esse recurso, envie um e-mail para bq-vector-search@google.com.
A visualização INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
contém uma linha para cada coluna indexada por vetor em cada tabela em um conjunto de dados.
Permissões necessárias
Para ver os metadados do índice vetorial, é preciso ter a permissão bigquery.tables.get
ou bigquery.tables.list
do Identity and Access Management (IAM) na tabela com o índice. Cada um dos seguintes papéis predefinidos
do IAM inclui pelo menos uma destas permissões:
roles/bigquery.admin
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.dataViewer
roles/bigquery.metadataViewer
roles/bigquery.user
Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.
Schema
Os resultados das consultas na visualizaçãoINFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
contêm uma linha para cada coluna indexada de cada tabela do conjunto de dados.
A visualização INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS
tem o seguinte esquema:
Nome da coluna | Tipo de dados | Valor |
---|---|---|
index_catalog |
STRING |
Nome do projeto que contém o conjunto de dados. |
index_schema |
STRING |
O nome do conjunto de dados que contém o índice vetorial. |
table_name |
STRING |
O nome da tabela em que o índice vetorial é criado. |
index_name |
STRING |
O nome do índice vetorial. |
index_column_name |
STRING |
O nome da coluna indexada. |
index_field_path |
STRING |
O caminho completo do campo indexado expandido, começando com o nome da coluna. Os campos são separados por um ponto. |
Escopo e sintaxe
As consultas nesta visualização precisam ter um qualificador de conjunto de dados. A tabela a seguir explica o escopo da região dessa visualização:
Ver nome | Escopo do recurso | Escopo da região |
---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS |
Nível do conjunto de dados | Local do conjunto de dados |
- Opcional:
PROJECT_ID
: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado. DATASET_ID
: ID do conjunto de dados. Para mais informações, consulte Qualificador de conjunto de dados.
Exemplo
-- Returns metadata for vector indexes in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;
Examples
A consulta a seguir extrai informações de colunas que têm índices vetoriais:
SELECT table_name, index_name, index_column_name, index_field_path FROM my_project.dataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;
O resultado será semelhante ao seguinte:
+------------+------------+-------------------+------------------+ | table_name | index_name | index_column_name | index_field_path | +------------+------------+-------------------+------------------+ | table1 | indexa | a | a | | table2 | indexb | b | b | | table3 | indexc | c | c | +------------+------------+-------------------+------------------+