Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
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:
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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-17 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES\u003c/code\u003e view provides a real-time record of all changes made to capacity commitments within an administration project, with each row detailing a single change.\u003c/p\u003e\n"],["\u003cp\u003eQuerying this view requires the \u003ccode\u003ebigquery.capacityCommitments.list\u003c/code\u003e IAM permission, which is included in roles such as \u003ccode\u003eroles/bigquery.resourceAdmin\u003c/code\u003e, \u003ccode\u003eroles/bigquery.resourceEditor\u003c/code\u003e, \u003ccode\u003eroles/bigquery.resourceViewer\u003c/code\u003e, \u003ccode\u003eroles/bigquery.user\u003c/code\u003e, and \u003ccode\u003eroles/bigquery.admin\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach entry in the view includes details like the \u003ccode\u003echange_timestamp\u003c/code\u003e, \u003ccode\u003eproject_id\u003c/code\u003e, \u003ccode\u003ecapacity_commitment_id\u003c/code\u003e, \u003ccode\u003ecommitment_plan\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003eslot_count\u003c/code\u003e, \u003ccode\u003eaction\u003c/code\u003e, and the \u003ccode\u003euser_email\u003c/code\u003e that initiated the change.\u003c/p\u003e\n"],["\u003cp\u003eThe data in this view is retained for a maximum of 41 days after a capacity commitment is deleted, after which it is permanently removed from the view.\u003c/p\u003e\n"],["\u003cp\u003eQueries against this view must include a region qualifier, and the location of the query execution must match the region of the \u003ccode\u003eINFORMATION_SCHEMA\u003c/code\u003e view.\u003c/p\u003e\n"]]],[],null,["# CAPACITY_COMMITMENT_CHANGES view\n================================\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view contains a near\nreal-time list of all changes to capacity commitments within the administration\nproject. Each row represents a single change to a single capacity commitment.\nFor more information, see [Slot commitments](/bigquery/docs/reservations-workload-management#slot_commitments).\n\nRequired permission\n-------------------\n\nTo query the `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view,\nyou need the `bigquery.capacityCommitments.list` Identity and Access Management (IAM)\npermission for the project.\nEach of the following predefined IAM roles includes the required\npermission:\n\n- `roles/bigquery.resourceAdmin`\n- `roles/bigquery.resourceEditor`\n- `roles/bigquery.resourceViewer`\n- `roles/bigquery.user`\n- `roles/bigquery.admin`\n\nFor more information about BigQuery permissions, see\n[Access control with IAM](/bigquery/docs/access-control).\n\nSchema\n------\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES` view has the\nfollowing schema:\n\nData retention\n--------------\n\nThis view contains current capacity commitments and the deleted capacity\ncommitments that are kept for a maximum of 41 days after which they are removed\nfrom the view.\n\nScope and syntax\n----------------\n\nQueries against this view must include a [region qualifier](/bigquery/docs/information-schema-intro#syntax).\nIf you do not specify a regional qualifier, metadata is retrieved from all\nregions. The following table explains the region scope for this view:\n\nReplace the following:\n\n- Optional: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project. If not specified, the default project is used.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: any [dataset region name](/bigquery/docs/locations). For example, ```region-us```.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n | **Note:** You must use [a region qualifier](/bigquery/docs/information-schema-intro#region_qualifier) to query `INFORMATION_SCHEMA` views. The location of the query execution must match the region of the `INFORMATION_SCHEMA` view.\n\n\u003cbr /\u003e\n\nExample\n-------\n\nThe following query displays the user who has made the latest capacity commitment\nupdate to the current project within the specified date. \n\n```googlesql\nSELECT\n user_email,\n change_timestamp\nFROM\n `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES\nWHERE\n change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'\nORDER BY\n change_timestamp DESC\nLIMIT 1;\n```\n\nThe result is similar to the following: \n\n```\n+--------------------------------+-------------------------+\n| user_email | change_timestamp |\n+--------------------------------+-------------------------+\n| 222larabrown@gmail.com | 2021-09-30 09:30:00 UTC |\n+--------------------------------+-------------------------+\n\n```"]]
