Ansicht ASSIGNMENT_CHANGES

Die Ansicht INFORMATION_SCHEMA.ASSIGNMENT_CHANGES enthält eine Liste aller Änderungen an Zuweisungen im Administrationsprojekt. Jede Zeile steht für eine einzelne Änderung an einer einzelnen Zuweisung. Weitere Informationen zur Reservierung finden Sie unter Einführung in Reservierungen.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.ASSIGNMENT_CHANGES-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.reservationAssignments.list für das Projekt. 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.ASSIGNMENT_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.
assignment_id STRING ID, die die Zuweisung eindeutig kennzeichnet.
reservation_name STRING Name der Reservierung, die die Zuweisung verwendet.
job_type STRING Die Art des Jobs, der die Reservierung verwenden kann. Kann PIPELINE oder QUERY sein.
assignee_id STRING ID, die die Ressource des Empfängers der Zuweisung eindeutig identifiziert.
assignee_number INTEGER Zahl, die die Ressource des Empfängers der Zuweisung eindeutig identifiziert.
assignee_type STRING Typ der zugewiesenen Ressource. Kann organization, folder oder project sein.
action STRING Typ des Ereignisses, das bei der Zuweisung 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.
state STRING Status der Zuweisung. Kann PENDING oder ACTIVE sein.

Datenaufbewahrung

Diese Ansicht enthält aktuelle Zuweisungen und gelöschte Zuweisungen. Letztere werden bis zu 41 Tage beibehalten und dann 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.ASSIGNMENT_CHANGES[_BY_PROJECT] Projektebene REGION
Dabei gilt:

  • 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 Nutzer angezeigt, der die letzte Zuweisungsaktualisierung bei einer bestimmten Zuweisung innerhalb eines bestimmten Datums vorgenommen hat.

SELECT
  user_email,
  change_timestamp,
  reservation_name,
  assignment_id
FROM
  `region-us`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
  AND assignment_id = 'assignment_01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

Das Ergebnis sieht etwa so aus:

+--------------------------------+-----------------------+--------------------+-----------------+
|           user_email           |    change_timestamp   |  reservation_name  |  assignment_id  |
+--------------------------------+-----------------------+--------------------+-----------------+
|  cloudysanfrancisco@gmail.com  |2021-09-30 09:30:00 UTC|   my_reservation   |  assignment_01  |
+--------------------------------+-----------------------+--------------------+-----------------+