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) en el proyecto. Cada uno de los siguientes roles predefinidos de IAM incluye el permiso requerido:

  • Administrador de recursos de BigQuery (roles/bigquery.resourceAdmin)
  • Editor de recursos de BigQuery (roles/bigquery.resourceEditor)
  • Visualizador 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 Roles y permisos de IAM 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 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.
primary_location STRING Es la ubicación actual de la réplica principal de la reserva. Este campo solo se establece para las reservas que usan la función de recuperación ante desastres administrada .
secondary_location STRING Es la ubicación actual de la réplica secundaria de la reserva. Este campo solo se establece para las reservas que usan la función de recuperación ante desastres administrada .
original_primary_location STRING Es la ubicación en la que se creó originalmente la reserva.
labels RECORD Es un array de etiquetas asociadas con la reserva.
reservation_group_path ARRAY<STRING> Es el grupo de reservas al que está vinculada la reserva. Por ejemplo, si la reserva está vinculada al grupo my-group, el campo reservation_group_path contiene una lista como la siguiente: [my-group].
max_slots INTEGER Es la cantidad máxima de ranuras que puede usar esta reserva, que incluye ranuras de referencia (slot_capacity), ranuras inactivas (si ignore_idle_slots es falso) y ranuras de ajuste de escala automático. Los usuarios especifican este campo para usar la función de previsibilidad de la reserva.
scaling_mode STRING Es el modo de ajuste de escala para la reserva, que determina cómo se ajusta la escala de la reserva desde el modelo de referencia hasta max_slots. Los usuarios especifican este campo para usar la función de previsibilidad de la reserva.

Para lograr estabilidad, te recomendamos que enumeres de forma explícita las columnas en las consultas del esquema de información en lugar de usar un comodín (SELECT *). Si enumeras las columnas de forma explícita, se evita que las consultas se interrumpan si cambia el esquema subyacente.

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: Es el ID de tu Cloud de Confiance 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 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;