Vista ORGANIZATION_OPTIONS_CHANGES
Puedes consultar la vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES para obtener metadatos en tiempo real sobre los cambios en la configuración de BigQuery de una organización.
En esta vista se reflejan los cambios en la configuración a nivel de organización y de proyecto que se hayan realizado después del 31 de enero del 2024.
Permisos obligatorios
Para obtener el permiso que necesitas para obtener los cambios de configuración,
pide a tu administrador que te conceda el
rol de gestión de identidades y accesos Administrador de BigQuery (roles/bigquery.admin) en tu organización.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene el permiso bigquery.config.update, que es necesario para obtener los cambios de configuración.
También puedes obtener este permiso con roles personalizados u otros roles predefinidos.
Esquema
Cuando consultas la vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, los resultados de la consulta 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 la que se produjo el cambio de configuración. |
username |
STRING |
En el caso de los usuarios propios, se trata de su correo electrónico. En el caso de los usuarios externos, es el nombre que los usuarios definen en el proveedor de identidades externo. |
updated_options |
JSON |
Un objeto JSON de las opciones de configuración que los usuarios han actualizado en el cambio, que contiene los valores anteriores y los nuevos de los campos actualizados. |
project_id |
STRING |
El ID del proyecto. Este campo está vacío en los cambios de configuración a nivel de organización. |
project_number |
INTEGER |
El número de proyecto. Este campo está vacío en los cambios de configuración a nivel de organización. |
Conservación de datos
Esta vista contiene las sesiones que están en curso 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.ORGANIZATION_OPTIONS_CHANGES |
Cambios de configuración en la organización especificada. | REGION |
Haz los cambios siguientes:
REGION: cualquier nombre de región del conjunto de datos. Por ejemplo,USous-west2.
Ejemplos
En el ejemplo siguiente 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}} |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+