Visualizzazione EFFECTIVE_PROJECT_OPTIONS

Puoi eseguire una query sulla vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS per recuperare metadati in tempo reale sulle opzioni di progetto effettive di BigQuery. Questa visualizzazione contiene le impostazioni predefinite a livello di organizzazione o progetto.

Autorizzazioni obbligatorie

Per ottenere metadati efficaci delle opzioni di progetto, devi disporre dell'autorizzazione bigquery.config.get Identity and Access Management (IAM).

Il seguente ruolo IAM predefinito include le autorizzazioni necessarie per ottenere metadati efficaci delle opzioni di progetto:

  • roles/bigquery.jobUser

Per ulteriori informazioni sulle autorizzazioni BigQuery granulari, consulta Ruoli e autorizzazioni.

Schema

Quando esegui una query nella 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 il seguente schema:

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 dell'oggetto OPTION_VALUE.
OPTION_SET_LEVEL STRING Il livello della gerarchia in cui è definita l'impostazione, con possibili valori DEFAULT, ORGANIZATION o PROJECTS.
OPTION_SET_ON_ID STRING Imposta il valore in base al valore OPTION_SET_LEVEL:
  • Se DEFAULT, imposta null.
  • Se ORGANIZATION, imposta "".
  • 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 predefinito della chiave effettiva per questo progetto.
default_query_job_timeout_ms INT64 Il timeout effettivo della query predefinita in millisecondi per progetto.
default_interactive_query_queue_timeout_ms STRING Il timeout predefinito effettivo in millisecondi per le sessioni interattive in coda query per questo progetto.
default_batch_query_queue_timeout_ms STRING Timeout predefinito effettivo in millisecondi per le query batch in coda per questo progetto.

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 vista devono avere un qualificatore 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+