Vista PROJECT_OPTIONS

Pode consultar a vista INFORMATION_SCHEMA.PROJECT_OPTIONS para obter metadados em tempo real sobre as opções do projeto do BigQuery. Esta vista contém opções de configuração que foram definidas ao nível do projeto. Para ver os valores predefinidos de uma opção de configuração, consulte as definições de configuração.

Autorizações necessárias

Para obter metadados de opções de configuração, precisa das seguintes autorizações de gestão de identidade e de acesso (IAM):

  • bigquery.config.get

A seguinte função de IAM predefinida inclui as autorizações de que precisa para obter metadados de opções do projeto:

  • roles/bigquery.jobUser

Para mais informações acerca das autorizações detalhadas do BigQuery, consulte as funções e autorizações.

Esquema

Quando consulta a vista INFORMATION_SCHEMA.PROJECT_OPTIONS, os resultados da consulta contêm uma linha para cada opção de configuração num projeto que difere do valor predefinido.

A vista INFORMATION_SCHEMA.PROJECT_OPTIONS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
OPTION_NAME STRING ID da opção para a definição de configuração especificada.
OPTION_DESCRIPTION STRING A 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 predefinido para este projeto.
default_kms_key_name STRING O nome da chave predefinido para este projeto.
default_query_job_timeout_ms STRING O tempo limite de consulta predefinido em milissegundos para este projeto. Isto também se aplica a consultas contínuas.
default_interactive_query_queue_timeout_ms STRING O tempo limite predefinido em milissegundos para consultas interativas em fila para este projeto.
default_batch_query_queue_timeout_ms STRING O tempo limite predefinido em milissegundos para consultas em lote colocadas em fila para este projeto.

Retenção de dados

Esta vista contém as sessões em execução e o histórico de sessões concluídas nos últimos 180 dias.

Âmbito e sintaxe

As consultas nesta vista têm de ter um qualificador de região.

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS Opções de configuração no projeto especificado. REGION

Substitua o seguinte:

Exemplos

O exemplo seguinte obtém as colunas OPTION_NAME, OPTION_TYPE e OPTION_VALUE da vista INFORMATION_SCHEMA.PROJECT_OPTIONS.

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

O resultado é 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             |
  +--------------------------------------------+-------------+---------------------+