Vista RESERVATION_CHANGES

La vista INFORMATION_SCHEMA.RESERVATION_CHANGES contiene una lista casi en tiempo real de todos los cambios realizados en las reservas del proyecto de administración. Cada fila representa un cambio en una sola reserva. Para obtener más información, consulta el artículo Introducción a las reservas.

Permiso obligatorio

Para consultar la vista INFORMATION_SCHEMA.RESERVATION_CHANGES, necesitas el permiso bigquery.reservations.list de gestión de identidades y accesos (IAM) en el proyecto. Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye el permiso necesario:

  • Administrador de recursos de BigQuery (roles/bigquery.resourceAdmin)
  • Editor de recursos de BigQuery (roles/bigquery.resourceEditor)
  • Lector de recursos de BigQuery (roles/bigquery.resourceViewer)
  • Usuario de BigQuery (roles/bigquery.user)
  • Administrador de BigQuery (roles/bigquery.admin)

Para obtener más información sobre los permisos de BigQuery, consulta el artículo sobre los roles y permisos de gestión de identidades y accesos de BigQuery.

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 la reserva proporcionado por el usuario.
ignore_idle_slots BOOL Si es false, cualquier consulta que use esta reserva puede usar las ranuras inactivas sin usar de otros compromisos de capacidad.
action STRING Tipo de evento que se ha producido con la reserva. Puede ser CREATE, UPDATE o DELETE.
slot_capacity INTEGER Valor de referencia de la reserva.
user_email STRING Dirección de correo del usuario o asunto de la federación de identidades de la plantilla que ha realizado el cambio. google para ver los cambios que ha hecho Google. NULL si la dirección de correo no se conoce.
target_job_concurrency INTEGER El número objetivo de consultas que se pueden ejecutar simultáneamente, que está limitado por los recursos disponibles. Si es cero, este valor se calcula automáticamente en función de los recursos disponibles.
autoscale STRUCT

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

  • current_slots: número de espacios que se han añadido a la reserva mediante el ajuste de escala automático.
  • max_slots: número máximo de espacios que se pueden añadir a la reserva mediante el ajuste de escala automático.
edition STRING La edición asociada a esta reserva. Para obtener más información sobre las ediciones, consulta Introducción a las ediciones de BigQuery.
primary_location STRING Ubicación actual de la réplica principal de la reserva. Este campo solo se define en las reservas que usan la función de recuperación ante desastres gestionada.
secondary_location STRING Ubicación actual de la réplica secundaria de la reserva. Este campo solo se define en las reservas que usan la función de recuperación ante desastres gestionada.
original_primary_location STRING Ubicación en la que se creó originalmente la reserva.
labels RECORD Matriz de etiquetas asociadas a la reserva.
max_slots INTEGER El número máximo de ranuras que puede usar esta reserva, incluidas las ranuras de base (slot_capacity), las ranuras inactivas (si ignore_idle_slots es false) y las ranuras de escalado automático. Los usuarios especifican este campo para usar la función de previsibilidad de reservas.
scaling_mode STRING El modo de escalado de la reserva, que determina cómo se escala la reserva desde la línea de base hasta max_slots. Los usuarios especifican este campo para usar la función de previsibilidad de reservas.

Conservación de datos

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

Ámbito y sintaxis

Las consultas en esta vista deben incluir un calificador de región. Si no especifica un calificador regional, los metadatos se recuperan de todas las regiones. En la siguiente tabla se explica el ámbito de la región de esta vista:

Nombre de la vista Ámbito de los recursos Ámbito de la región
[PROJECT_ID].`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] Nivel de proyecto REGION
Sustituye lo siguiente:
  • Opcional: PROJECT_ID: el ID de tu Google Cloud proyecto. Si no se especifica, se usa el proyecto predeterminado.
  • REGION: cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Ejemplo

En el siguiente ejemplo se obtiene el historial de cambios de una reserva determinada. Usa esta información para ver la lista de cambios realizados en una reserva específica, como la creación o la eliminación de la reserva.

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