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 la configuración predeterminada a nivel de la organización o del proyecto.
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 |
---|---|---|
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 :
|
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 efectivo 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.EFFECTIVE_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
, 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 | +--------------------------------------------+-------------+---------------------+------------------+--------------------+