Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ansicht RESERVATION_CHANGES
Die Ansicht INFORMATION_SCHEMA.RESERVATION_CHANGES enthält eine nahezu in Echtzeit aktualisierte Liste aller Änderungen an Reservierungen im Administrationsprojekt. Jede Zeile steht für eine Änderung an einer einzelnen Reservierung. Weitere Informationen finden Sie unter Einführung in Reservierungen.
Erforderliche Berechtigung
Zum Abfragen der Ansicht INFORMATION_SCHEMA.RESERVATION_CHANGES benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.reservations.list.
Jede der folgenden vordefinierten IAM-Rollen enthält die erforderliche Berechtigung:
Die Ansicht INFORMATION_SCHEMA.RESERVATION_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.
reservation_name
STRING
Vom Nutzer bereitgestellter Reservierungsname.
ignore_idle_slots
BOOL
Bei "false" kann jede Abfrage, die diese Reservierung verwendet, inaktive Slots aus anderen Kapazitätszusicherungen verwenden.
action
STRING
Typ des Ereignisses, das bei der Reservierung aufgetreten ist. Kann CREATE, UPDATE oder DELETE sein.
slot_capacity
INTEGER
Referenz der Reservierung.
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.
target_job_concurrency
INTEGER
Die Zielanzahl an Abfragen, die gleichzeitig ausgeführt werden können. Diese wird durch die verfügbaren Ressourcen begrenzt. Wenn der Wert „0“ ist, wird er automatisch anhand der verfügbaren Ressourcen berechnet.
autoscale
STRUCT
Informationen zur Autoscaling-Kapazität der Reservierung. Zu den Feldern gehören:
current_slots: die Anzahl der Slots, die durch Autoscaling der Reservierung hinzugefügt wurden.
max_slots: die maximale Anzahl an Slots, die der Reservierung durch Autoscaling hinzugefügt werden können.
edition
STRING
Die mit dieser Reservierung verknüpfte Edition. Weitere Informationen zu Editionen finden Sie unter Einführung in BigQuery-Editionen.
primaryLocation
STRING
Der aktuelle Speicherort des primären Replikats der Reservierung. Dieses Feld wird nur für Reservierungen festgelegt, bei denen die verwaltete Notfallwiederherstellung verwendet wird.
secondaryLocation
STRING
Der aktuelle Speicherort des sekundären Replikats der Reservierung. Dieses Feld wird nur für Reservierungen festgelegt, bei denen die verwaltete Notfallwiederherstellung verwendet wird.
originalPrimaryLocation
STRING
Der Standort, an dem die Reservierung ursprünglich erstellt wurde.
labels
RECORD
Array von Labels, die mit der Reservierung verknüpft sind.
max_slots
INTEGER
Die maximale Anzahl von Slots, die diese Reservierung verwenden kann. Dazu gehören Referenz-Slots (slot_capacity), inaktive Slots (wenn ignore_idle_slots auf „false“ gesetzt ist) und Autoscale-Slots. Dieses Feld wird von Nutzern für die Nutzung der Funktion zur Vorhersagbarkeit von Reservierungen angegeben.
scaling_mode
STRING
Der Skalierungsmodus für die Reservierung, der bestimmt, wie die Reservierung von der Basis bis zu max_slots skaliert wird. Dieses Feld wird von Nutzern für die Nutzung der Funktion zur Vorhersagbarkeit von Reservierungen angegeben.
Datenaufbewahrung
Diese Ansicht enthält aktuelle Reservierungen und gelöschte Reservierungen, die maximal 41 Tage gespeichert bleiben. Danach werden sie aus der Ansicht entfernt.
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:
Im folgenden Beispiel wird der Verlauf der Änderungen für eine bestimmte Reservierung abgerufen. Damit erhalten Sie eine Liste der Änderungen, die an dieser Reservierung vorgenommen wurden, z. B. das Erstellen oder Löschen der Reservierung.
[[["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-25 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.RESERVATION_CHANGES\u003c/code\u003e view provides a real-time log of all changes made to reservations within the administration project, with each row representing a single change event.\u003c/p\u003e\n"],["\u003cp\u003eQuerying this view requires the \u003ccode\u003ebigquery.reservations.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 entry in the view includes details like the \u003ccode\u003echange_timestamp\u003c/code\u003e, \u003ccode\u003eproject_id\u003c/code\u003e, \u003ccode\u003ereservation_name\u003c/code\u003e, \u003ccode\u003eaction\u003c/code\u003e (CREATE, UPDATE, DELETE), and other information about the change.\u003c/p\u003e\n"],["\u003cp\u003eThe view retains data on current and deleted reservations for up to 41 days before they are removed.\u003c/p\u003e\n"],["\u003cp\u003eQueries to this view need to specify a region using a region qualifier, and the query execution location must match the region of the view.\u003c/p\u003e\n"]]],[],null,["# RESERVATION_CHANGES view\n========================\n\nThe `INFORMATION_SCHEMA.RESERVATION_CHANGES` view contains a near real-time list\nof all changes to reservations within the administration project. Each row\nrepresents a change to a single reservation. For more information, see\n[Introduction to reservations](/bigquery/docs/reservations-intro).\n\nRequired permission\n-------------------\n\nTo query the `INFORMATION_SCHEMA.RESERVATION_CHANGES` view, you need\nthe `bigquery.reservations.list` Identity and Access Management (IAM) permission on the\nproject.\nEach of the following predefined IAM roles includes the required\npermission:\n\n- BigQuery Resource Admin (`roles/bigquery.resourceAdmin`)\n- BigQuery Resource Editor (`roles/bigquery.resourceEditor`)\n- BigQuery Resource Viewer (`roles/bigquery.resourceViewer`)\n- BigQuery User (`roles/bigquery.user`)\n- BigQuery Admin (`roles/bigquery.admin`)\n\nFor more information about BigQuery permissions, see\n[BigQuery IAM roles and permissions](/bigquery/docs/access-control).\n\nSchema\n------\n\nThe `INFORMATION_SCHEMA.RESERVATION_CHANGES` view has the\nfollowing schema:\n\nData retention\n--------------\n\nThis view contains current reservations and deleted reservations that are\nkept 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 example gets the history of changes for a given reservation. Use\nthis information to see the list of changes made to a specific reservation, such\nas creating or deleting the reservation. \n\n```googlesql\nSELECT\n *\nFROM\n reservation-admin-project.`region-us`.\n INFORMATION_SCHEMA.RESERVATION_CHANGES\nWHERE\n reservation_name = \"\u003cvar translate=\"no\"\u003emy-reservation\u003c/var\u003e\"\nORDER BY\n change_timestamp DESC;\n```"]]
