Visualização de EFFECTIVE_PROJECT_OPTIONS

É possível consultar a visualização INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS para recuperar metadados em tempo real sobre as opções efetivas do projeto do BigQuery. Essa visualização contém configurações padrão nos níveis da organização ou do projeto.

Permissões necessárias

Para acessar metadados de opções de projeto eficazes, você precisa da permissão bigquery.config.get do Identity and Access Management (IAM).

O papel predefinido do IAM a seguir inclui as permissões necessárias para receber metadados de opções de projeto eficazes:

  • roles/bigquery.jobUser

Para mais informações sobre permissões granulares do BigQuery, consulte papéis e permissões.

Esquema

Quando você consulta a visualização INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS, os resultados da consulta contêm uma linha para cada configuração em um projeto.

A visualização INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
OPTION_NAME STRING Código da opção da configuração especificada
OPTION_DESCRIPTION STRING Descrição da opção
OPTION_TYPE STRING O tipo de dados de OPTION_VALUE
OPTION_SET_LEVEL STRING Nível da hierarquia em que a configuração está definida, com os valores possíveis de DEFAULT, ORGANIZATION ou PROJECTS
OPTION_SET_ON_ID STRING Defina o valor com base no valor de OPTION_SET_LEVEL:
  • Se DEFAULT. defina como null.
  • Se ORGANIZATION. defina como "".
  • Se PROJECT. defina como ID.
OPTION_VALUE STRING O valor atual da opção
Tabela de opções
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING O fuso horário padrão efetivo para este projeto
default_kms_key_name STRING O nome da chave padrão efetiva para este projeto
default_query_job_timeout_ms INT64 O tempo limite padrão da consulta efetivo em milissegundos para este projeto.
default_interactive_query_queue_timeout_ms STRING O tempo limite padrão efetivo em milissegundos para consultas interativas na fila deste projeto.
default_batch_query_queue_timeout_ms STRING O tempo limite padrão efetivo em milissegundos para consultas em lote na fila para este projeto.

Retenção de dados

Essa visualização contém as sessões em execução no momento e o histórico de sessões concluídos nos últimos 180 dias.

Escopo e sintaxe

As consultas nesta visualização precisam ter um qualificador de região.

Nome da visualização Escopo do recurso Escopo da região
`region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS Opções de configuração no projeto especificado. REGION

Substitua:

Exemplos

O exemplo a seguir recupera as colunas OPTION_NAME, OPTION_TYPE, OPTION_VALUE, OPTION_SET_LEVEL e OPTION_SET_ON_ID da visualização 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;

O resultado será semelhante ao seguinte:

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