Vista de PROJECT_OPTIONS

Puedes consultar la vista INFORMATION_SCHEMA.PROJECT_OPTIONS para recuperar metadatos en tiempo real sobre las opciones de proyecto de BigQuery. Esta vista contiene las opciones de configuración que se establecieron a nivel del proyecto. Para ver los valores predeterminados de una opción de configuración, consulta parámetros de configuración.

Permisos necesarios

Para obtener los metadatos de opciones de configuración, necesitas los siguientes permisos de Identity and Access Management (IAM):

  • bigquery.config.get

El siguiente rol predefinido de IAM incluye los permisos que necesitas para obtener los metadatos de las opciones del proyecto:

  • roles/bigquery.jobUser

Si deseas obtener más información acerca de los permisos de BigQuery en detalle, consulta los roles y las permisos.

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.PROJECT_OPTIONS, los resultados contienen una fila por cada opción de configuración de un proyecto que difiere del valor predeterminado.

La vista INFORMATION_SCHEMA.PROJECT_OPTIONS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
option_name STRING ID de opción para la configuración especificada.
project_id STRING El ID del proyecto.
project_number INTEGER Es el número del proyecto.
option_description STRING La descripción de la opción.
option_type STRING El tipo de datos de OPTION_VALUE.
option_value STRING El valor actual de la opción.
Tabla de opciones
option_name option_type option_value
default_time_zone STRING La zona horaria predeterminada de este proyecto.
default_kms_key_name STRING El nombre de la clave predeterminada de este proyecto.
default_query_job_timeout_ms STRING El tiempo de espera de consulta predeterminado en milisegundos para este proyecto. Esto también se aplica a las consultas continuas.
default_interactive_query_queue_timeout_ms STRING El tiempo de espera predeterminado efectivo en milisegundos para las consultas interactivas en cola de este proyecto.
default_batch_query_queue_timeout_ms STRING El tiempo de espera predeterminado efectivo en milisegundos para las consultas por lotes en cola para este proyecto.

Retención de datos

Esta vista contiene las sesiones que se están ejecutando y el historial de sesiones completadas en los últimos 180 días.

Permiso y sintaxis

Las consultas realizadas a esta vista deben tener un calificador de región.

Nombre de la vista Permiso del recurso Permiso de la región
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS Opciones de configuración dentro del proyecto especificado REGION

Reemplaza lo siguiente:

Ejemplos

En el siguiente ejemplo, se recuperan las columnas OPTION_NAME, OPTION_TYPE y OPTION_VALUE de la vista INFORMATION_SCHEMA.PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

El resultado es similar al siguiente:

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+