Esta página se ha traducido con Cloud Translation API.

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 del 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 autoescalado 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. Nota: Después de que los usuarios reduzcan `max_slots`, puede que tarde un tiempo en propagarse, por lo que `current_slots` puede mantener el valor original y ser mayor que `max_slots` durante ese breve periodo (menos de un minuto). `max_slots`: número máximo de ranuras que se pueden añadir a la reserva mediante el escalado 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.
`reservation_group_path`	`STRING`	Estructura de grupo jerárquica a la que está vinculada la reserva. Por ejemplo, si la estructura del grupo incluye un grupo principal y un grupo secundario, el campo `reservation_group_path` contiene una lista como la siguiente: `[parent group, child group]`. Este campo está en versión preliminar.
`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`	Modo de escalado de la reserva, que determina cómo se escala la reserva desde la base hasta `max_slots`. Los usuarios especifican este campo para usar la función de previsibilidad de reservas.

Por motivos de estabilidad, te recomendamos que incluyas explícitamente las columnas en tus consultas de esquema de información en lugar de usar un comodín (SELECT *). Si incluyes las columnas explícitamente, evitarás que las consultas fallen si cambia el esquema subyacente.

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 proyecto. Google Cloud Si no se especifica, se usa el proyecto predeterminado.
REGION: cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Nota: Debes usar un calificador de región para consultar vistas de INFORMATION_SCHEMA. La ubicación de la consulta debe coincidir con la región de la vista INFORMATION_SCHEMA.

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;