Vista EFFECTIVE_PROJECT_OPTIONS

Puede consultar la vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS para obtener metadatos en tiempo real sobre las opciones de proyecto efectivas de BigQuery. Esta vista contiene opciones de configuración que se definen a nivel de organización o proyecto. Si la misma opción de configuración se define tanto a nivel de organización como de proyecto, se muestra el valor de la configuración del proyecto. Para ver los valores predeterminados de una opción de configuración, consulta Ajustes de configuración.

Permisos obligatorios

Para obtener metadatos de opciones de proyecto eficaces, necesitas el permiso de bigquery.config.getGestión de Identidades y Accesos (IAM).

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

  • 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.EFFECTIVE_PROJECT_OPTIONS, los resultados de la consulta contienen una fila por cada configuración de un proyecto.

La vista INFORMATION_SCHEMA.EFFECTIVE_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_SET_LEVEL STRING El nivel de la jerarquía en el que se define el ajuste, con los valores posibles DEFAULT, ORGANIZATION o PROJECTS.
OPTION_SET_ON_ID STRING Define el valor en función del valor de OPTION_SET_LEVEL:
  • Si DEFAULT, asigna el valor null.
  • Si ORGANIZATION, asigna el valor "".
  • Si PROJECT, asigna el valor ID.
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 efectiva de este proyecto.
default_kms_key_name STRING Nombre de la clave predeterminada efectiva de este proyecto.
default_query_job_timeout_ms INT64 Tiempo de espera de consulta predeterminado efectivo en milisegundos de este proyecto.
default_interactive_query_queue_timeout_ms STRING 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 en lote en cola de este proyecto.
enable_reservation_based_fairness BOOL Usar la equidad basada en reservas en lugar de la equidad basada en proyectos.

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.EFFECTIVE_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, OPTION_VALUE, OPTION_SET_LEVEL y OPTION_SET_ON_ID de la vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value, option_set_level, option_set_on_id
FROM
  `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

El resultado es similar al siguiente:

  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | option_name                                | option_type | option_value        | option_set_level | option_set_on_id   |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles | organizations    | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              | organization     | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+