Ansicht RESERVATION_CHANGES

Die Ansicht INFORMATION_SCHEMA.RESERVATION_CHANGES enthält eine Liste aller Änderungen an Reservierungen im Administrationsprojekt nahezu in Echtzeit. 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:

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.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 der Abfragen, die gleichzeitig ausgeführt werden können. Diese ist durch die verfügbaren Ressourcen begrenzt. Wenn null, wird dieser Wert 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.

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:

Ansichtsname	Ressourcenbereich	Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RESERVATION_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

Hinweis: Zum Abfragen von INFORMATION_SCHEMA-Ansichten müssen Sie einen Regions-Qualifier verwenden. Der Ort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

Beispiel

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.

SELECT
  *
FROM
  `reservation-admin-project.region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;