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, vedi 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 saperne di più 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
project_id STRING L'ID del progetto.
project_number INTEGER Numero del progetto.
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 DEFAULT, ORGANIZATION o PROJECTS.
option_set_on_id STRING Imposta il valore in base al valore di option_set_level:
  • Se DEFAULT, impostato su null.
  • Se ORGANIZATION, impostato su "".
  • Se PROJECT, impostato su ID.
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.

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.EFFECTIVE_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, 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+