Ansicht ORGANIZATION_OPTIONS_CHANGES

Sie können die Ansicht INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES abfragen, um Echtzeit-Metadaten zu BigQuery-Konfigurationsänderungen in einer Organisation abzurufen. Diese Ansicht zeigt Konfigurationsänderungen auf Organisations- und Projektebene, die nach dem 31. Januar 2024 vorgenommen wurden.

Erforderliche Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die BigQuery-Administrator (roles/bigquery.admin) IAM-Rolle für die Organisation zu gewähren, um die Berechtigung zu erhalten, die Sie zum Abrufen der Konfigurationsänderungen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Brechtigung bigquery.config.update, die zum Abrufen der Konfigurationsänderungen erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Schema

Wenn Sie die Ansicht INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES abfragen, enthält das Ergebnis für jede Konfigurationsänderung in einer Organisation eine Zeile.

Die Ansicht INFORMATION_SCHEMA.ORGANIZATION_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.

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.ORGANIZATION_OPTIONS_CHANGES Konfigurationsänderungen innerhalb der angegebenen Organisation. REGION

Ersetzen Sie Folgendes:

Beispiele

Im folgenden Beispiel werden alle Änderungen der Option default_query_job_timeout_ms option abgerufen:

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

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_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+