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:
  • Se DEFAULT, imposta su null.
  • Se ORGANIZATION, imposta su "".
  • Se PROJECT, imposta 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.

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