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:

REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, US o us-west2.

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}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+