Visualização de PROJECT_OPTIONS

É possível consultar a visualização INFORMATION_SCHEMA.PROJECT_OPTIONS para recuperar metadados em tempo real sobre as opções do projeto do BigQuery. Essa visualização contém configurações padrão no nível do projeto.

Permissões necessárias

Para receber metadados de opções da configuração, você precisa das seguintes permissões de gerenciamento de identidade e acesso (IAM):

  • bigquery.config.get

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

  • 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.PROJECT_OPTIONS, os resultados da consulta contêm uma linha para cada configuração em um projeto.

A visualização INFORMATION_SCHEMA.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_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 para este projeto
default_kms_key_name STRING O nome da chave padrão para este projeto
default_query_job_timeout_ms STRING O tempo limite padrão da consulta em milissegundos para este projeto.
default_interactive_query_queue_timeout_ms STRING O tempo limite padrão em milissegundos para consultas interativas na fila para este projeto.
default_batch_query_queue_timeout_ms STRING O tempo limite padrão 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.PROJECT_OPTIONS Opções de configuração no projeto especificado. REGION

Substitua:

Exemplos

O exemplo a seguir recupera as colunas OPTION_NAME, OPTION_TYPE e OPTION_VALUE da visualização INFORMATION_SCHEMA.PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

O resultado será semelhante ao seguinte:

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+