Visualizzazione EFFECTIVE_PROJECT_OPTIONS
Puoi eseguire query sulla visualizzazione INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
per
recuperare i metadati in tempo reale sulle opzioni di progetto effettive di BigQuery.
Questa visualizzazione contiene le opzioni di configurazione impostate a livello di organizzazione o progetto. Se la stessa opzione di configurazione è impostata sia a livello di organizzazione
che di progetto, viene visualizzato il valore di configurazione del progetto. Per visualizzare i valori
predefiniti per un'opzione di configurazione, consulta Impostazioni
di configurazione.
Autorizzazioni obbligatorie
Per ottenere i metadati delle opzioni di progetto effettive, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.config.get
.
Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per ottenere i metadati delle opzioni di progetto efficaci:
roles/bigquery.jobUser
Per ulteriori informazioni sulle autorizzazioni BigQuery granulari, consulta ruoli e autorizzazioni.
Schema
Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
, i risultati della query contengono una riga per ogni configurazione in un progetto.
La vista INFORMATION_SCHEMA.EFFECTIVE_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 di OPTION_VALUE . |
OPTION_SET_LEVEL |
STRING |
Il livello della gerarchia in cui è definita l'impostazione, con valori possibili di DEFAULT , ORGANIZATION o PROJECTS .
|
OPTION_SET_ON_ID |
STRING |
Imposta il valore in base al valore di OPTION_SET_LEVEL :
|
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 effettivo per questo progetto. |
default_kms_key_name |
STRING |
Il nome della chiave predefinita effettiva per questo progetto. |
default_query_job_timeout_ms |
INT64 |
Il timeout predefinito effettivo della query in millisecondi per questo progetto. |
default_interactive_query_queue_timeout_ms |
STRING |
Il timeout predefinito effettivo in millisecondi per le query interattive in coda per questo progetto. |
default_batch_query_queue_timeout_ms |
STRING |
Il timeout predefinito effettivo in millisecondi per le query batch in coda per questo progetto. |
enable_reservation_based_fairness |
BOOL |
Utilizza l'equità basata sulle prenotazioni anziché quella basata sui progetti. |
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.EFFECTIVE_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
, OPTION_VALUE
, OPTION_SET_LEVEL
e OPTION_SET_ON_ID
dalla visualizzazione INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
.
SELECT option_name, option_type, option_value, option_set_level, option_set_on_id FROM `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;
Il risultato è simile al seguente:
+--------------------------------------------+-------------+---------------------+------------------+--------------------+ | option_name | option_type | option_value | option_set_level | option_set_on_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_time_zone | STRING | America/Los_Angeles | organizations | my_organization_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_kms_key_name | STRING | test/testkey1 | projects | my_project_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_query_job_timeout_ms | INT64 | 18000000 | projects | my_project_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_interactive_query_queue_timeout_ms | INT64 | 600000 | organization | my_organization_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+ | default_batch_query_queue_timeout_ms | INT64 | 1200000 | projects | my_project_id | +--------------------------------------------+-------------+---------------------+------------------+--------------------+