Vista PROJECT_OPTIONS_CHANGES

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

Permisos necesarios

Para obtener la configuración, necesitas el permiso bigquery.config.update de Identity and Access Management (IAM) a nivel de proyecto. El rol predefinido de IAM roles/bigquery.admin incluye los permisos que necesitas para crear una configuración.

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

La vista INFORMATION_SCHEMA.PROJECT_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.PROJECT_OPTIONS_CHANGES Cambios de configuración dentro del proyecto especificado. REGION

Reemplaza lo siguiente:

Ejemplos

En el ejemplo que se muestra a continuación, se recuperan todas las columnas de la vista INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;

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_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+