Vue CAPACITY_COMMITMENT_CHANGES

INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES contient une liste en quasi-temps réel de toutes les modifications apportées aux engagements de capacité dans le projet d'administration. Chaque ligne représente une modification apportée à un seul engagement de capacité. Pour en savoir plus sur la réservation, consultez la section Engagements.

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.capacityCommitments.list pour le projet. 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.CAPACITY_COMMITMENT_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.
capacity_commitment_id STRING ID qui identifie de manière unique l'engagement de capacité.
commitment_plan STRING Forfait de l'engagement de capacité.
state STRING État de l'engagement de capacité. Il peut s'agir de PENDING ou ACTIVE.
slot_count INTEGER Nombre d'emplacements associés à l'engagement de capacité.
action STRING Type d'événement survenu avec l'engagement de capacité. Il peut s'agir de CREATE, UPDATE ou DELETE.
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.
commitment_start_time TIMESTAMP Début de la période d'engagement en cours. Ne s'applique qu'aux engagements de capacité ACTIVE. Sinon, la valeur est NULL.
commitment_end_time TIMESTAMP Fin de la période d'engagement en cours. Ne s'applique qu'aux engagements de capacité ACTIVE. Sinon, la valeur est NULL.
failure_status RECORD Indique le motif de l'échec pour un forfait avec engagement à l'état FAILED. Sinon, la valeur est NULL. RECORD est constitué d'un code et d'un message.
renewal_plan STRING Forfait vers lequel cet engagement de capacité est converti une fois le champ commitment_end_time transmis. Après modification du forfait, la période d'engagement est prolongée conformément à celui-ci. Ne s'applique qu'aux engagements ANNUAL et TRIAL. Sinon, la valeur est NULL.
edition STRING Édition associée à cette réservation. Pour en savoir plus sur les éditions, consultez la page Présentation des éditions BigQuery.
is_flat_rate BOOL Indique si l'engagement est associé à l'ancien modèle de capacité forfaitaire ou à une édition. Si la valeur est FALSE, l'engagement en cours est associé à une édition. Si la valeur est TRUE, l'engagement correspond à l'ancien modèle de capacité forfaitaire.

Conservation des données

Cette vue contient les engagements de capacité en cours et les engagements de capacité supprimés. Ceux-ci sont conservés 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.CAPACITY_COMMITMENT_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 : tout nom de région d'ensemble de données. Exemple : region-us.

Exemple

La requête suivante affiche l'utilisateur qui a effectué la dernière mise à jour d'engagement de capacité sur le projet actuel à la date spécifiée.

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

Le résultat ressemble à ce qui suit :

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+