Visualização de PROJECT_OPTIONS

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

Permissões necessárias

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

bigquery.config.get

O seguinte papel predefinido do IAM 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.

Schema

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:

REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us.

Examples

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