Visualizzazione ORGANIZATION_OPTIONS_CHANGES

Puoi eseguire query sulla visualizzazione INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES per recuperare i metadati in tempo reale sulle modifiche alla configurazione di BigQuery in un'organizzazione. Questa visualizzazione riflette le modifiche alla configurazione a livello di organizzazione e a livello di progetto apportate dopo il 31 gennaio 2024.

Autorizzazioni obbligatorie

Per ottenere l'autorizzazione necessaria per ottenere le modifiche alla configurazione, chiedi all'amministratore di concederti il ruolo IAM BigQuery Admin (roles/bigquery.admin) nella tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito include l'autorizzazione bigquery.config.update necessaria per ottenere le modifiche alla configurazione.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Schema

Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, i risultati della query contengono una riga per ogni modifica alla configurazione in un'organizzazione.

La visualizzazione INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES ha il seguente schema:

Nome colonna Tipo di dati Valore
update_time TIMESTAMP L'ora in cui si è verificata la modifica alla configurazione.
username STRING Per gli utenti di prima parte, è la loro email utente. Per gli utenti di terze parti, è il nome che gli utenti hanno impostato nel provider di identità di terze parti.
updated_options JSON Un oggetto JSON delle opzioni di configurazione aggiornate dagli utenti nella modifica, contenente i valori precedenti e quelli nuovi dei campi aggiornati.
project_id STRING L'ID progetto. Questo campo è vuoto per le modifiche alla configurazione a livello di organizzazione.
project_number INTEGER Il numero del progetto. Questo campo è vuoto per le modifiche alla configurazione a livello di organizzazione.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema informativo anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

Conservazione dei dati

Questa visualizzazione contiene le sessioni in esecuzione e la cronologia delle sessioni completate negli ultimi 180 giorni.

Ambito e sintassi

Le query su questa visualizzazione devono avere un qualificatore di regione.

Nome vista Ambito risorsa Ambito regione
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES Modifiche alla configurazione all'interno dell'organizzazione specificata. REGION

Sostituisci quanto segue:

Esempi

Il seguente esempio recupera tutte le modifiche dell'opzione default_query_job_timeout_ms option:

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

Il risultato è simile al seguente:

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| 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}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+