Vista ORGANIZATION_OPTIONS_CHANGES

Puedes consultar la vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES para recuperar metadatos en tiempo real sobre los cambios de configuración de BigQuery en una organización. En esta vista, se reflejan los cambios de configuración a nivel de proyecto y de la organización que se realizaron después del 31 de enero de 2024.

Permisos necesarios

Para obtener el permiso que necesitas para obtener los cambios de configuración, pídele a tu administrador que te otorgue el rol de IAM Administrador de BigQuery (roles/bigquery.admin) en la organización. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Este rol predefinido contiene el permiso bigquery.config.update, que se requiere para obtener los cambios de configuración.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, los resultados contienen una fila por cada cambio de configuración de una organización.

La vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
update_time TIMESTAMP La hora en que se produjo el cambio de configuración.
username STRING En el caso de los usuarios propios, es el correo electrónico de cada usuario. Para usuarios de terceros, es el nombre que los usuarios configuraron en el proveedor de identidad de terceros.
updated_options JSON Un objeto JSON de las opciones de configuración que los usuarios actualizaron en el cambio, que contiene los valores anteriores y nuevos de los campos actualizados.
project_id STRING El ID del proyecto. Este campo está vacío para los cambios de configuración a nivel de la organización.
project_number INTEGER Número del proyecto. Este campo está vacío para los cambios de configuración a nivel de la 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_CHANGES Cambios de configuración en la organización especificada. REGION

Reemplaza lo siguiente:

Ejemplos

En el siguiente ejemplo, se recuperan todos los cambios de la opción default_query_job_timeout_ms option:

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

El resultado es similar al siguiente:

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+