Vista PROJECT_OPTIONS_CHANGES

Vista previa

Esta función está sujetas a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Nota: Para obtener asistencia o enviar comentarios sobre los cambios en la configuración a nivel de proyecto, ponte en contacto con [e-mail].

Puedes consultar la vista INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES para obtener metadatos en tiempo real sobre los cambios en la configuración de BigQuery de un proyecto. Esta vista refleja los cambios en la configuración a nivel de proyecto que se hayan realizado después del 31 de enero del 2024.

Permisos obligatorios

Para obtener la configuración, necesitas el permiso bigquery.config.updateGestión de Identidades y Accesos (IAM) a nivel de proyecto. El rol de gestión de identidades y accesos predefinido roles/bigquery.admin incluye los permisos que necesitas para crear una configuración.

Para obtener más información sobre los permisos detallados de BigQuery, consulta los roles y permisos.

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES, los resultados de la consulta contienen una fila por cada cambio de 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 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.PROJECT_OPTIONS_CHANGES	Cambios de configuración en el proyecto especificado.	REGION

Haz los cambios siguientes:

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

Nota: Para saber cómo extraer un valor escalar JSON de la columna updated_options y convertirlo en un valor STRING de SQL, como JSON_VALUE(), consulta las funciones JSON.

Ejemplos

En el siguiente ejemplo se obtienen todas las columnas de la vista INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

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

Nota: Los nombres de las vistas de INFORMATION_SCHEMA distinguen entre mayúsculas y minúsculas.

El resultado es similar al siguiente:

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | [e-mail] | {"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 | [e-mail] | {"default_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+