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 efficaci 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'bigquery.config.get autorizzazione 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 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 del 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 di OPTION_SET_LEVEL:
  • Se DEFAULT, imposta null.
  • Se ORGANIZATION, imposta "".
  • Se PROJECT, imposta ID.
OPTION_VALUE STRING Il valore corrente 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 efficace per questo progetto.
default_query_job_timeout_ms INT64 Il timeout predefinito effettivo delle query in millisecondi per questo progetto.
default_interactive_query_queue_timeout_ms STRING Il timeout predefinito effettivo in millisecondi per le query interattive messe 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.

Conservazione dei dati

Questa visualizzazione contiene le sessioni in esecuzione e la cronologia delle sessioni completate negli ultimi 180 giorni.

Ambito e sintassi

Le query su questa visualizzazione 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+