Ansicht CAPACITY_COMMITMENT_CHANGES

Die Ansicht INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES enthält eine nahezu in Echtzeit aktualisierte Liste aller Änderungen an Kapazitätszusicherungen im Administrationsprojekt. Jede Zeile steht für eine einzelne Änderung an einer einzelnen Kapazitätszusicherung. Weitere Informationen zu Reservierungen finden Sie unter Zusicherungen.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES-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_COMMITMENT_CHANGES hat das folgende Schema:

Spaltenname Datentyp Wert
change_timestamp TIMESTAMP Zeit, zu der die Änderung erfolgt ist.
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.
action STRING Typ des Ereignisses, das bei der Kapazitätszusicherung aufgetreten ist. Kann CREATE, UPDATE oder DELETE sein.
user_email STRING E-Mail-Adresse des Nutzers oder Subjekts der Workload Identity-Föderation, die die Änderung vorgenommen hat. google für von Google vorgenommene Änderungen. NULL, wenn die E-Mail-Adresse unbekannt ist.
commitment_start_time TIMESTAMP Der Beginn des aktuellen Zusicherungszeitraums. Gilt nur für ACTIVE-Kapazitätszusicherungen, andernfalls NULL.
commitment_end_time TIMESTAMP Das Ende des aktuellen Zusicherungszeitraums. Gilt nur für ACTIVE-Kapazitätszusicherungen, andernfalls NULL.
failure_status RECORD Bei einem FAILED-Zusicherungstarif wird der Fehlergrund angegeben, andernfalls NULL. RECORD besteht aus code und message.
renewal_plan STRING Der Tarif, in den diese Kapazitätszusicherung konvertiert wird, nachdem die commitment_end_time verstrichen ist. Nachdem der Tarif geändert wurde, wird der Zusicherungszeitraum gemäß dem Zusicherungstarif verlängert. Gilt nur für ANNUAL- und TRIAL-Zusicherungen, andernfalls NULL.
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.

Datenaufbewahrung

Diese Ansicht enthält aktuelle Kapazitätszusicherungen und die gelöschten Kapazitätszusicherungen, die maximal 41 Tage lang aufbewahrt werden und danach aus der Ansicht entfernt werden.

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

Die folgende Abfrage zeigt den Nutzer an, der die letzte Aktualisierung der Kapazitätszusicherung für das aktuelle Projekt innerhalb des angegebenen Zeitrahmens vorgenommen hat.

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;

Das Ergebnis sieht etwa so aus:

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