Visualizzazione PROJECT_OPTIONS
Puoi eseguire query sulla visualizzazione INFORMATION_SCHEMA.PROJECT_OPTIONS
per recuperare i metadati in tempo reale sulle opzioni del progetto BigQuery. Questa visualizzazione contiene le impostazioni predefinite a livello di progetto.
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 autorizzazioni necessarie per ottenere i metadati delle opzioni di progetto:
roles/bigquery.jobUser
Per ulteriori informazioni sulle autorizzazioni BigQuery granulari, consulta Ruoli e autorizzazioni.
Schema
Quando esegui una query sulla vista INFORMATION_SCHEMA.PROJECT_OPTIONS
, i risultati della query contengono una riga per ogni configurazione in un progetto.
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. |
OPTION_DESCRIPTION |
STRING |
La descrizione dell'opzione. |
OPTION_TYPE |
STRING |
Il tipo di dati del 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 predefinito della chiave per questo progetto. |
default_query_job_timeout_ms |
STRING |
Il timeout predefinito per le query in millisecondi per questo progetto. |
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 in esecuzione e la cronologia delle sessioni completate negli ultimi 180 giorni.
Ambito e sintassi
Le query su questa vista devono avere un qualificatore regione.
Nome vista | Ambito risorsa | Ambito della regione |
---|---|---|
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS |
Opzioni di configurazione all'interno del progetto specificato. | REGION |
Sostituisci quanto segue:
REGION
: qualsiasi nome della regione del set di dati. Ad esempio:region-us
.
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 | +--------------------------------------------+-------------+---------------------+