Vista de EFFECTIVE_PROJECT_OPTIONS

Puedes consultar la vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS para recuperar metadatos en tiempo real sobre las opciones efectivas de los proyectos de BigQuery. Esta vista contiene opciones de configuración que se establecen a nivel de la organización o del proyecto. Si el mismo parámetro de configuración se establece a nivel de la organización y del proyecto, se muestra el valor de configuración 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 del proyecto eficaces, necesitas el permiso bigquery.config.get de la administración de identidades y accesos (IAM).

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

  • 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.EFFECTIVE_PROJECT_OPTIONS, los resultados 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
project_id STRING El ID del proyecto.
project_number INTEGER Es el número del proyecto.
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_set_level STRING El nivel de jerarquía en el que se define la configuración, con valores posibles de DEFAULT, ORGANIZATION o PROJECTS
option_set_on_id STRING Establece el valor en función del valor de option_set_level:
  • Si es DEFAULT, configúralo como null.
  • Si es ORGANIZATION, configúralo como "".
  • Si es PROJECT, configúralo como ID.
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 vigente de este proyecto
default_kms_key_name STRING El nombre de la clave predeterminada vigente para este proyecto
default_query_job_timeout_ms INT64 El tiempo de espera de consulta predeterminado efectivo en milisegundos para este proyecto.
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 eficaz en milisegundos para las consultas por lotes en cola para este proyecto.
enable_reservation_based_fairness BOOL Usa la equidad basada en reservas en lugar de la equidad basada en proyectos.

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.EFFECTIVE_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, 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+