Vista de COLUMN_FIELD_PATHS
La vista INFORMATION_SCHEMA.COLUMN_FIELD_PATHS contiene una fila para cada columna anidada dentro de una columna RECORD (o STRUCT).
Permisos necesarios
Para consultar la vista INFORMATION_SCHEMA.COLUMN_FIELD_PATHS, necesitas los siguientes permisos de Identity and Access Management (IAM):
bigquery.tables.getbigquery.tables.list
Cada uno de los siguientes roles predefinidos de IAM incluye los permisos anteriores:
roles/bigquery.adminroles/bigquery.dataViewerroles/bigquery.dataEditorroles/bigquery.metadataViewer
Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.
Esquema
Los resultados de la consulta contienen una fila por cada columna anidada dentro de una columna RECORD (o STRUCT).
Cuando consultas la vista INFORMATION_SCHEMA.COLUMN_FIELD_PATHS, los resultados contienen una fila por cada columna anidada dentro de una columna RECORD (o STRUCT).
La vista INFORMATION_SCHEMA.COLUMN_FIELD_PATHS tiene el siguiente esquema:
| Nombre de la columna | Tipo de datos | Valor |
|---|---|---|
table_catalog |
STRING |
El ID del proyecto que contiene el conjunto de datos. |
table_schema |
STRING |
El nombre del conjunto de datos que contiene la tabla (también denominado datasetId) |
table_name |
STRING |
El nombre de la tabla o la vista (también denominado tableId) |
column_name |
STRING |
Es el nombre de la columna |
field_path |
STRING |
Es la ruta a una columna anidada dentro de una columna “RECORD” o “STRUCT”. |
data_type |
STRING |
El tipo de datos de GoogleSQL de la columna |
description |
STRING |
Es la descripción de la columna. |
collation_name |
STRING |
El nombre de la especificación de la intercalación, si existe; de lo contrario, NULL.Si se pasa un campo STRING, ARRAY<STRING> o STRING en un STRUCT, se devuelve la especificación de intercalación si existe; de lo contrario, se devuelve NULL.
|
rounding_mode |
STRING |
El modo de redondeo que se usa cuando se aplica precisión y escalamiento a valores NUMERIC o BIGNUMERIC parametrizados; de lo contrario, el valor es NULL.
|
data_policies.name |
STRING |
Es la lista de políticas de datos que se adjuntan a la columna para controlar el acceso y el enmascaramiento. Este campo está en (vista previa). |
policy_tags |
ARRAY<STRING> |
Es la lista de etiquetas de política adjuntas a la columna. |
Para mayor estabilidad, te recomendamos que enumeres de forma explícita las columnas en tus consultas de esquema de información en lugar de usar un comodín (SELECT *). Enumerar las columnas de forma explícita evita que las consultas se interrumpan si cambia el esquema subyacente.
Permiso y sintaxis
Las consultas realizadas a esta vista deben incluir un conjunto de datos o un calificador de región. Para consultas con un calificador de conjunto de datos, debes tener permisos para el conjunto de datos. Para consultas con un calificador de región, debes tener permisos para el proyecto. Para obtener más información, consulta Sintaxis. En la siguiente tabla, se explican los permisos de la región y los recursos para esta vista:
| Nombre de la vista | Permiso del recurso | Permiso de la región |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.COLUMN_FIELD_PATHS |
Nivel de proyecto | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.COLUMN_FIELD_PATHS |
Nivel de conjunto de datos | Ubicación del conjunto de datos |
-
Opcional:
PROJECT_ID: Es el ID de tu proyecto de Google Cloud . Si no se especifica, se usa el proyecto predeterminado. -
REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo,`region-us`. -
DATASET_ID: Es el ID del conjunto de datos. Para obtener más información, consulta Calificador de conjunto de datos.
Ejemplo
En el siguiente ejemplo, se recuperan los metadatos desde la vista INFORMATION_SCHEMA.COLUMN_FIELD_PATHS para la tabla commits en el conjunto de datos github_repos.
Este conjunto de datos es parte del programa de conjuntos de datos públicos de BigQuery.
Debido a que la tabla que consultas está en otro proyecto, bigquery-public-data, debes agregar el ID del proyecto al conjunto de datos en el siguiente formato: `project_id`.dataset.INFORMATION_SCHEMA.view; por ejemplo, `bigquery-public-data`.github_repos.INFORMATION_SCHEMA.COLUMN_FIELD_PATHS.
La tabla commits contiene las siguientes columnas anidadas, y anidadas y repetidas:
author: columna anidadaRECORDcommitter: columnaRECORDanidadatrailer: columnaRECORDanidada y repetidadifference: columnaRECORDanidada y repetida
Para ver los metadatos de las columnas author y difference, ejecuta la siguiente consulta.
SELECT * FROM `bigquery-public-data`.github_repos.INFORMATION_SCHEMA.COLUMN_FIELD_PATHS WHERE table_name = 'commits' AND (column_name = 'author' OR column_name = 'difference');
El resultado es similar al siguiente. Para facilitar la lectura, algunas columnas se excluyen del resultado.
+------------+-------------+---------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+-------------+-------------+ | table_name | column_name | field_path | data_type | description | policy_tags | +------------+-------------+---------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+-------------+-------------+ | commits | author | author | STRUCT<name STRING, email STRING, time_sec INT64, tz_offset INT64, date TIMESTAMP> | NULL | 0 rows | | commits | author | author.name | STRING | NULL | 0 rows | | commits | author | author.email | STRING | NULL | 0 rows | | commits | author | author.time_sec | INT64 | NULL | 0 rows | | commits | author | author.tz_offset | INT64 | NULL | 0 rows | | commits | author | author.date | TIMESTAMP | NULL | 0 rows | | commits | difference | difference | ARRAY<STRUCT<old_mode INT64, new_mode INT64, old_path STRING, new_path STRING, old_sha1 STRING, new_sha1 STRING, old_repo STRING, new_repo STRING>> | NULL | 0 rows | | commits | difference | difference.old_mode | INT64 | NULL | 0 rows | | commits | difference | difference.new_mode | INT64 | NULL | 0 rows | | commits | difference | difference.old_path | STRING | NULL | 0 rows | | commits | difference | difference.new_path | STRING | NULL | 0 rows | | commits | difference | difference.old_sha1 | STRING | NULL | 0 rows | | commits | difference | difference.new_sha1 | STRING | NULL | 0 rows | | commits | difference | difference.old_repo | STRING | NULL | 0 rows | | commits | difference | difference.new_repo | STRING | NULL | 0 rows | +------------+-------------+---------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------+-------------+-------------+