Vue RESERVATION_CHANGES

La vue INFORMATION_SCHEMA.RESERVATION_CHANGES contient une liste en quasi-temps réel de toutes les modifications apportées aux réservations dans le projet d'administration. Chaque ligne représente une modification apportée à une seule réservation. Pour en savoir plus, consultez la page Présentation des réservations.

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.RESERVATION_CHANGES, vous devez disposer de l'autorisation Identity and Access Management (IAM) bigquery.reservations.list. Chacun des rôles IAM prédéfinis suivants inclut l'autorisation requise :

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

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

La vue INFORMATION_SCHEMA.RESERVATION_CHANGES présente le schéma suivant :

Nom de la colonne Type de données Valeur
change_timestamp TIMESTAMP Heure à laquelle la modification s'est produite.
project_id STRING ID du projet d'administration.
project_number INTEGER Numéro du projet d'administration.
reservation_name STRING Nom de réservation fourni par l'utilisateur.
ignore_idle_slots BOOL Si la valeur est définie sur "false", toute requête utilisant cette réservation peut exploiter des emplacements inactifs provenant d'autres engagements de capacité.
action STRING Type d'événement survenu lors de la réservation. Il peut s'agir de CREATE, UPDATE ou DELETE.
slot_capacity INTEGER Référence de la réservation.
user_email STRING Adresse e-mail de l'utilisateur ou sujet de la fédération d'identité de personnel ayant effectué la modification. google pour les modifications apportées par Google. NULL si l'adresse e-mail est inconnue.
target_job_concurrency INTEGER Nombre cible de requêtes pouvant être exécutées simultanément, qui est limité par les ressources disponibles. Si ce nombre est égal à zéro, la valeur est calculée automatiquement en fonction des ressources disponibles.
autoscale STRUCT

Informations sur la capacité d'autoscaling de la réservation. Les champs incluent les suivants :

  • current_slots : nombre d'emplacements ajoutés à la réservation par l'autoscaling.
  • max_slots : nombre maximal d'emplacements pouvant être ajoutés à la réservation par autoscaling.
edition STRING Édition associée à cette réservation. Pour en savoir plus sur les éditions, consultez la page Présentation des éditions BigQuery.

Conservation des données

Cette vue contient les réservations en cours et les réservations supprimées qui sont conservées pendant 41 jours maximum après leur suppression de la vue.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Si vous ne spécifiez pas de qualificatif de région, les métadonnées sont extraites de toutes les régions. Le tableau suivant explique le champ d'application de la région pour cette vue :

Nom de la vue Champ d'application de la ressource Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT] Niveau Projet REGION
Remplacez les éléments suivants :

  • Facultatif : PROJECT_ID : ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.
 + REGION : nom de la région de l'ensemble de données. Par exemple, region-us.

Exemple

Dans l'exemple suivant, on récupère l'historique des modifications pour une réservation donnée. Utilisez ces informations pour afficher la liste des modifications apportées à une réservation spécifique, telles que la création ou la suppression de la réservation.

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