Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
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:
[[["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_COMMITMENTS\u003c/code\u003e view provides a real-time list of all current, pending, or active capacity commitments within a specified administration project.\u003c/p\u003e\n"],["\u003cp\u003eQuerying this view requires \u003ccode\u003ebigquery.capacityCommitments.list\u003c/code\u003e IAM permission, which is included in several predefined roles like \u003ccode\u003eroles/bigquery.resourceAdmin\u003c/code\u003e and \u003ccode\u003eroles/bigquery.user\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach row in the view represents a single capacity commitment, including details such as its ID, commitment plan, current state (\u003ccode\u003ePENDING\u003c/code\u003e or \u003ccode\u003eACTIVE\u003c/code\u003e), slot count, and associated edition.\u003c/p\u003e\n"],["\u003cp\u003eQueries against the \u003ccode\u003eINFORMATION_SCHEMA.CAPACITY_COMMITMENTS\u003c/code\u003e view must include a region qualifier specifying the dataset region, for example, \u003ccode\u003eregion-us\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eis_flat_rate\u003c/code\u003e column indicates whether the commitment is associated with the legacy flat-rate capacity model (\u003ccode\u003eTRUE\u003c/code\u003e) or an edition (\u003ccode\u003eFALSE\u003c/code\u003e).\u003c/p\u003e\n"]]],[],null,["# CAPACITY_COMMITMENTS view\n=========================\n\nThe `INFORMATION_SCHEMA.CAPACITY_COMMITMENTS` view contains a near real-time\nlist of all current capacity commitments within the administration project. Each\nrow represents a single, current capacity commitment. A current capacity\ncommitment is either pending or active and has not been deleted. For more\ninformation about reservation, see [Slot commitments](/bigquery/docs/reservations-workload-management#slot_commitments).\n\nRequired permission\n-------------------\n\nTo query the `INFORMATION_SCHEMA.CAPACITY_COMMITMENTS` 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_COMMITMENTS` view has the\nfollowing schema:\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 example returns a list of active capacity commitments for the\ncurrent project: \n\n```googlesql\nSELECT\n capacity_commitment_id,\n slot_count\nFROM\n `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS\nWHERE\n state = 'ACTIVE';\n```\n\nThe result is similar to the following: \n\n```\n+------------------------+------------+\n| capacity_commitment_id | slot_count |\n+------------------------+------------+\n| my_commitment_05 | 1000 |\n| my_commitment_06 | 1000 |\n| my_commitment_07 | 1500 |\n| my_commitment_08 | 2000 |\n+------------------------+------------+\n```"]]
