Vista VECTOR_INDEX_COLUMNS

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para enviar comentarios o solicitar asistencia para esta función, envía un correo electrónico a [e-mail].

La vista INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS contiene una fila para cada columna con indexación vectorial en cada tabla en un conjunto de datos.

Permisos necesarios

Para ver los metadatos del índice vectorial, necesitas el permiso bigquery.tables.get o bigquery.tables.list de Identity and Access Management (IAM) en la tabla con el índice. Cada una de los siguientes roles predefinidos de IAM incluye, al menos, uno de estos permisos:

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

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Schema

Cuando consultas la vista INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS, los resultados de la consulta contienen una fila por cada columna indexada de cada tabla de un conjunto de datos.

La vista INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS tiene el siguiente esquema:

Nombre de la columna	Tipo de datos	Valor
index_catalog	STRING	El nombre del proyecto que contiene el conjunto de datos.
index_schema	STRING	Es el nombre del conjunto de datos que contiene el índice vectorial.
table_name	STRING	El nombre de la tabla en la que se crea el índice vectorial.
index_name	STRING	Es el nombre del índice vectorial.
index_column_name	STRING	El nombre de la columna indexada.
index_field_path	STRING	La ruta completa del campo indexado expandido, que comienza con el nombre de la columna. Los campos están separados por un punto.

Permiso y sintaxis

Las consultas realizadas a esta vista deben tener un calificador de conjunto de datos. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista	Permiso del recurso	Permiso de la región
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS	Nivel de conjunto de datos	Ubicación del conjunto de datos

Reemplaza lo siguiente:

• Opcional: PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.
• DATASET_ID: Es el ID del conjunto de datos. Para obtener más información, consulta calificador de conjunto de datos.

Nota: Debes especificar la ubicación para consultar las vistas de INFORMATION_SCHEMA y la ubicación de la ejecución de la consulta debe coincidir con la región de la vista de INFORMATION_SCHEMA.

Ejemplo

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

Ejemplos

La siguiente consulta extrae información sobre las columnas que tienen índices vectoriales:

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

El resultado es similar al siguiente:

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