Vista de ORGANIZATION_OPTIONS

Puedes consultar la vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS para recuperar metadatos en tiempo real sobre las opciones de la organización de BigQuery. Esta vista contiene información sobre las opciones de configuración de un proyecto que difieren de los valores predeterminados.

Permisos necesarios

Para obtener los metadatos de las opciones de la organizació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 de la organización:

  • roles/bigquery.jobUser

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

Esquema

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

La vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
OPTION_NAME STRING Uno de los valores de nombre de la tabla de opciones.
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 esta organización.
default_kms_key_name STRING El nombre de la clave predeterminada de esta organización.
default_query_job_timeout_ms STRING El tiempo de espera de consulta predeterminado en milisegundos para esta organización.
default_interactive_query_queue_timeout_ms STRING El tiempo de espera predeterminado en milisegundos para las consultas interactivas en cola de esta organización.
default_batch_query_queue_timeout_ms STRING El tiempo de espera predeterminado en milisegundos para las consultas por lotes en cola para esta organización.

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.ORGANIZATION_OPTIONS Opciones de configuración dentro de la organización especificada. REGION

Reemplaza lo siguiente:

Ejemplos

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

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_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             |
  +--------------------------------------------+-------------+---------------------+