Vista PROJECT_OPTIONS

Puedes consultar la vista INFORMATION_SCHEMA.PROJECT_OPTIONS para obtener metadatos en tiempo real sobre las opciones de los proyectos de BigQuery. Esta vista contiene opciones de configuración que se han definido a nivel de proyecto. Para ver los valores predeterminados de una opción de configuración, consulta Ajustes de configuración.

Permisos obligatorios

Para obtener los metadatos de las opciones de configuración, necesitas los siguientes permisos de Gestión de Identidades y Accesos (IAM):

  • bigquery.config.get

El siguiente rol de gestión de identidades y accesos predefinido incluye los permisos que necesitas para obtener los metadatos de las opciones de proyecto:

  • roles/bigquery.jobUser

Para obtener más información sobre los permisos detallados de BigQuery, consulta los roles y permisos.

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.PROJECT_OPTIONS, los resultados de la consulta 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 del ajuste de configuración especificado.
OPTION_DESCRIPTION STRING Descripción de la opción.
OPTION_TYPE STRING El tipo de datos de OPTION_VALUE.
OPTION_VALUE STRING 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 Nombre de clave predeterminado de este proyecto.
default_query_job_timeout_ms STRING Tiempo de espera predeterminado de las consultas en milisegundos para este proyecto. Esto también se aplica a las consultas continuas.
default_interactive_query_queue_timeout_ms STRING Tiempo de espera predeterminado en milisegundos para las consultas interactivas en cola de este proyecto.
default_batch_query_queue_timeout_ms STRING Tiempo de espera predeterminado en milisegundos para las consultas por lotes en cola de este proyecto.

Conservación de datos

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

Ámbito y sintaxis

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

Nombre de la vista Ámbito de los recursos Ámbito de la región
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS Opciones de configuración del proyecto especificado. REGION

Haz los cambios siguientes:

Ejemplos

En el siguiente ejemplo se obtienen 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             |
  +--------------------------------------------+-------------+---------------------+