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

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;