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 opções de configuração definidas no nível do projeto. Para conferir os valores padrão de uma opção de configuração, consulte Configurações.
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 opção de configuração em um projeto que difere do valor padrão.
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 |
project_id |
STRING |
O ID do projeto. |
project_number |
INTEGER |
Número do projeto. |
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. Isso também se aplica a consultas contínuas. |
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.
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 | +--------------------------------------------+-------------+---------------------+