Ansicht PROJECT_OPTIONS_CHANGES

Sie können die Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES abfragen, um Echtzeit-Metadaten zu BigQuery-Konfigurationsänderungen eines Projekts abzurufen. Diese Ansicht zeigt Konfigurationsänderungen auf Projektebene, die nach dem 31. Januar 2024 vorgenommen wurden.

Erforderliche Berechtigungen

Zum Abrufen der Konfiguration benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.config.update auf Projektebene. Die vordefinierte IAM-Rolle roles/bigquery.admin enthält die Berechtigungen, die Sie zum Erstellen einer Konfiguration benötigen.

Weitere Informationen über detaillierte BigQuery-Berechtigungen finden Sie unter Rollen und Berechtigungen.

Schema

Wenn Sie die INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES-Ansicht abfragen, wird im Ergebnis jede Konfigurationsänderung in einem Projekt in einer eigenen Zeile dargestellt.

Die Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES hat das folgende Schema:

Spaltenname Datentyp Wert
update_time TIMESTAMP Zeit, zu der die Konfigurationsänderung erfolgt ist
username STRING Bei Erstnutzern ist es die E-Mail-Adresse ihres Nutzers. Für externe Nutzer ist dies der Name, den Nutzer beim externen Identitätsanbieter festgelegt haben.
updated_options JSON Ein JSON-Objekt der Konfigurationsoptionen, die Nutzer bei der Änderung aktualisiert haben, enthält die vorherigen und neuen Werte der aktualisierten Felder.
project_id STRING Die Projekt-ID. Dieses Feld ist für Konfigurationsänderungen auf Organisationsebene leer.
project_number INTEGER Die Projektnummer. Dieses Feld ist für die Konfigurationsänderungen auf Organisationsebene leer.

Aus Stabilitätsgründen empfehlen wir, Spalten in Ihren Informationsschema-Abfragen explizit aufzulisten, anstatt ein Platzhalterzeichen (SELECT *) zu verwenden. So wird verhindert, dass Abfragen fehlschlagen, wenn sich das zugrunde liegende Schema ändert.

Datenaufbewahrung

Diese Ansicht enthält ausgeführte Sitzungen und den Verlauf der Sitzungen, die in den letzten 180 Tagen abgeschlossen wurden.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Region-Qualifizierer verwendet werden.

Ansichtsname Ressourcenbereich Regionsbereich
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES Konfigurationsänderungen innerhalb des angegebenen Projekts. REGION

Ersetzen Sie Folgendes:

Beispiele

Im folgenden Beispiel werden alle Spalten der Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES abgerufen.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;

Das Ergebnis sieht etwa so aus:

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+