Vista RESERVATION_CHANGES

La vista INFORMATION_SCHEMA.RESERVATION_CHANGES contiene una lista casi en tiempo real de todos los cambios que se realizaron en las reservas del proyecto de administración. Cada fila representa un cambio que se realizó en una reserva única. Para obtener más información, consulta Introducción a Reservations.

Permiso necesario

Para consultar la vista INFORMATION_SCHEMA.RESERVATION_CHANGES, necesitas el permiso bigquery.reservations.list de Identity and Access Management (IAM). Cada uno de los siguientes roles predefinidos de IAM incluye el permiso requerido:

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Esquema

La vista INFORMATION_SCHEMA.RESERVATION_CHANGES tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
change_timestamp TIMESTAMP Hora en la que se produjo el cambio.
project_id STRING ID del proyecto de administración.
project_number INTEGER Número del proyecto de administración.
reservation_name STRING Nombre de reserva que proporcionó el usuario.
ignore_idle_slots BOOL Si es falso, toda consulta que use esta reserva puede utilizar las ranuras inactivas de otros compromisos de capacidad.
action STRING El tipo de evento que ocurrió con la reserva. Puede ser CREATE, UPDATE o DELETE.
slot_capacity INTEGER Modelo de referencia de la reserva.
user_email STRING Dirección de correo electrónico del usuario o persona de la federación de Workforce Identity que realizó el cambio. google para los cambios que realizó Google. NULL si se desconoce la dirección de correo electrónico.
target_job_concurrency INTEGER La cantidad objetivo de consultas que pueden ejecutarse de forma simultánea, limitada por los recursos disponibles. Si es cero, este valor se calcula de forma automática en función de los recursos disponibles.
autoscale STRUCT

Información sobre la capacidad de ajuste de escala automático de la reserva. Los campos incluyen lo siguiente:

  • current_slots es la cantidad de ranuras que se agregaron a la reserva mediante el ajuste de escala automático.
  • max_slots es la cantidad máxima de ranuras que se pueden agregar a la reserva mediante el ajuste de escala automático.
edition STRING Es la edición asociada a esta reserva. Para obtener más información sobre las ediciones, consulta Introducción a las ediciones de BigQuery.

Retención de datos

Esta vista contiene las reservas actuales y las reservas borradas que se conservan durante un máximo de 41 días tras los cuales se quitan de la vista.

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. Si no especificas un calificador regional, los metadatos se recuperan de todas las regiones. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista Permiso del recurso Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] Nivel de proyecto REGION
Reemplaza lo siguiente:

  • Opcional: PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.
+ REGION: Cualquier nombre de región del conjunto de datos. Un ejemplo es region-us.

Ejemplo

En el siguiente ejemplo, se indica cómo obtener el historial de cambios de una reserva determinada. Usa esta información para ver la lista de cambios que se realizaron en una reserva específica, como crear o borrar la reserva.

SELECT
  *
FROM
  `reservation-admin-project.region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;