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 sia a livello di progetto, viene visualizzato il valore di configurazione del progetto. Per visualizzare i valori predefiniti
di un'opzione di configurazione, consulta Impostazioni di configurazione.
Autorizzazioni obbligatorie
Per ottenere i metadati delle opzioni di progetto effettive, devi disporre dell'autorizzazione bigquery.config.get di Identity and Access Management (IAM).
Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per ottenere i metadati delle opzioni di progetto effettive:
roles/bigquery.jobUser
Per saperne di più sulle autorizzazioni granulari di BigQuery, 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 visualizzazione INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS ha il seguente schema:
| Nome colonna | Tipo di dati | Valore |
|---|---|---|
project_id |
STRING |
L'ID del progetto. |
project_number |
INTEGER |
Il numero del progetto. |
option_name |
STRING |
L'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 nella gerarchia in cui è definita l'impostazione, con valori possibili 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 la fairness basata sulla prenotazione anziché la fairness basata sul progetto. |
reusable_column_aliases_mode |
STRING |
Indica se gli alias di colonna riutilizzabili sono abilitati in 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 regionale |
|---|---|---|
`region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS |
Opzioni di configurazione all'interno del progetto specificato. | REGION |
Sostituisci quanto segue:
REGION: il nome di una regione del set di dati. Ad esempio,region-us.
Esempi
Il seguente esempio 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 | +--------------------------------------------+-------------+---------------------+------------------+--------------------+