Ansicht CAPACITY_COMMITMENTS

Die Ansicht INFORMATION_SCHEMA.CAPACITY_COMMITMENTS enthält eine Liste aller aktuellen Kapazitätszusicherungen im Administrationsprojekt nahezu in Echtzeit. Jede Zeile steht für eine einzelne aktuelle Kapazitätszusicherung. Eine aktuelle Kapazitätszusicherung ist entweder ausstehend oder aktiv und wurde nicht gelöscht. Weitere Informationen zu Reservierungen finden Sie unter Zusicherungen.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.CAPACITY_COMMITMENTS-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.capacityCommitments.list für das Projekt. Jede der folgenden vordefinierten IAM-Rollen enthält die erforderliche Berechtigung:

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

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Schema

Die Ansicht INFORMATION_SCHEMA.CAPACITY_COMMITMENTS hat das folgende Schema:

Spaltenname Datentyp Wert
ddl STRING Die DDL-Anweisung, mit der diese Kapazitätszusicherung erstellt wurde.
project_id STRING ID des Administrationsprojekts.
project_number INTEGER Nummer des Administrationsprojekts.
capacity_commitment_id STRING ID, die die Kapazitätszusicherung eindeutig identifiziert.
commitment_plan STRING Zusicherungstarif der Kapazitätszusicherung.
state STRING Status, in dem sich die Kapazitätszusicherung befindet. Kann PENDING oder ACTIVE sein.
slot_count INTEGER Mit der Kapazitätszusicherung verknüpfte Slotanzahl.
edition STRING Die mit dieser Reservierung verknüpfte Edition. Weitere Informationen zu Editionen finden Sie unter Einführung in BigQuery-Editionen.
is_flat_rate BOOL Ob die Zusicherung dem Legacy-Pauschalpreis-Kapazitäts-modell oder einer Version zugeordnet ist. Wenn FALSE, wird die aktuelle Zusicherung einer Ausgabe zugeordnet. Bei TRUE ist die Zusicherung das Legacy-Pauschalpreismodell.
renewal_plan STRING Neuer Zusicherungsplan nach dem Ende des aktuellen Zusicherungsplans. Sie können den Verlängerungsplan für eine Zusicherung jederzeit bis zum Ablauf ändern.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Wenn Sie keinen regionalen Qualifier angeben, werden Metadaten aus allen Regionen abgerufen. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS[_BY_PROJECT] auf Projektebene REGION
Ersetzen Sie Folgendes:

  • Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: region-us

Beispiel

Im folgenden Beispiel wird eine Liste der aktiven Kapazitätszusicherungen für das aktuelle Projekt zurückgegeben:

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

Das Ergebnis sieht etwa so aus:

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