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 la configuración predeterminada a nivel de proyecto.

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.

Schema

Cuando consultas la vista INFORMATION_SCHEMA.PROJECT_OPTIONS, los resultados contienen una fila por cada configuración de un proyecto.

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.
`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.
`default_interactive_query_queue_timeout_ms`	`STRING`	El tiempo de espera predeterminado en milisegundos para las consultas interactivas en cola de este proyecto.
`default_batch_query_queue_timeout_ms`	`STRING`	El tiempo de espera predeterminado 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:

REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, region-us.

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             |
  +--------------------------------------------+-------------+---------------------+