Ansicht CAPACITY_COMMITMENTS

Die Ansicht INFORMATION_SCHEMA.CAPACITY_COMMITMENTS enthält eine Liste aller aktuellen Kapazitätszusicherungen im Administrationsprojekt. 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`

Dabei gilt:

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

Hinweis: Sie müssen den Standort angeben, um die INFORMATION_SCHEMA-Ansichten abzufragen, und der Standort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

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    |
+------------------------+------------+