Visualizzazione ORGANIZATION_OPTIONS

Puoi eseguire query sulla visualizzazione INFORMATION_SCHEMA.ORGANIZATION_OPTIONS per recuperare metadati in tempo reale sulle opzioni dell'organizzazione BigQuery. Questa visualizzazione contiene opzioni di configurazione impostate a livello di organizzazione. Per visualizzare i valori predefiniti di un'opzione di configurazione, vedi Impostazioni di configurazione.

Autorizzazioni obbligatorie

Per ottenere i metadati delle opzioni dell'organizzazione, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):

  • bigquery.config.get

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per ottenere i metadati delle opzioni dell'organizzazione:

  • roles/bigquery.jobUser

Per saperne di più sulle autorizzazioni BigQuery granulari, consulta Ruoli e autorizzazioni.

Schema

Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.ORGANIZATION_OPTIONS, i risultati della query contengono una riga per ogni opzione di configurazione in un progetto, se questa opzione differisce dal valore predefinito a livello di organizzazione.

La vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS ha lo schema seguente:

Nome colonna Tipo di dati Valore
option_name STRING Uno dei valori del nome nella tabella delle opzioni.
option_description STRING La descrizione dell'opzione.
option_type STRING Il tipo di dati di option_value.
option_value STRING Il valore attuale dell'opzione.
Tabella delle opzioni
option_name option_type option_value
default_time_zone STRING Il fuso orario predefinito per questa organizzazione.
default_kms_key_name STRING Il nome della chiave predefinita per questa organizzazione.
default_query_job_timeout_ms STRING Il timeout predefinito della query in millisecondi per questa organizzazione.
default_interactive_query_queue_timeout_ms STRING Il timeout predefinito in millisecondi per le query interattive in coda per questa organizzazione.
default_batch_query_queue_timeout_ms STRING Il timeout predefinito in millisecondi per le query batch in coda per questa 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 attualmente 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 Opzioni di configurazione all'interno dell'organizzazione specificata. REGION

Sostituisci quanto segue:

Esempi

L'esempio seguente recupera le colonne OPTION_NAME, OPTION_TYPE e OPTION_VALUE da INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Il risultato è simile al seguente:

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+