Vue CAPACITY_COMMITMENTS

La vue INFORMATION_SCHEMA.CAPACITY_COMMITMENTS contient une liste en quasi-temps réel de tous les engagements de capacité en cours dans le projet d'administration. Chaque ligne représente un seul engagement de capacité en cours. Un engagement de capacité en cours est en attente ou actif, et n'a pas été supprimé. Pour en savoir plus sur la réservation, consultez la section Engagements.

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, 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_COMMITMENTS présente le schéma suivant :

Nom de la colonne Type de données Valeur
ddl STRING Instruction LDD utilisée pour créer l'engagement de capacité.
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é.
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.
renewal_plan STRING Nouveau forfait d'engagement à la fin du forfait en cours. Vous pouvez modifier l'option de renouvellement d'un engagement à tout moment jusqu'à son expiration.

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_COMMITMENTS[_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

L'exemple suivant renvoie la liste des engagements de capacité actifs pour le projet en cours :

SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

Le résultat ressemble à ce qui suit :

+------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+