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 Identity and Access Management (IAM):

  • bigquery.config.get

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per ottenere i metadati delle opzioni del progetto:

  • roles/bigquery.jobUser

Per ulteriori informazioni 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.

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