Visualizzazione PROJECT_OPTIONS

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

Autorizzazioni obbligatorie

Per ottenere i metadati delle opzioni di configurazione, 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 del progetto:

  • roles/bigquery.jobUser

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

Schema

Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.PROJECT_OPTIONS, i risultati della query contengono una riga per ogni opzione di configurazione in un progetto diversa dal valore predefinito.

La vista INFORMATION_SCHEMA.PROJECT_OPTIONS ha lo schema seguente:

Nome colonna Tipo di dati Valore
option_name STRING ID opzione per l'impostazione di configurazione specificata.
project_id STRING L'ID del progetto.
project_number INTEGER Numero del progetto.
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 questo progetto.
default_kms_key_name STRING Il nome della chiave predefinito per questo progetto.
default_query_job_timeout_ms STRING Il timeout predefinito della query in millisecondi per questo progetto. Ciò vale anche per le query continue.
default_interactive_query_queue_timeout_ms STRING Il timeout predefinito in millisecondi per le query interattive in coda per questo progetto.
default_batch_query_queue_timeout_ms STRING Il timeout predefinito in millisecondi per le query batch in coda per questo progetto.

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.PROJECT_OPTIONS Opzioni di configurazione all'interno del progetto specificato. REGION

Sostituisci quanto segue:

Esempi

L'esempio seguente recupera le colonne OPTION_NAME, OPTION_TYPE e OPTION_VALUE dalla visualizzazione INFORMATION_SCHEMA.PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_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             |
  +--------------------------------------------+-------------+---------------------+