Vista EFFECTIVE_PROJECT_OPTIONS

Pode consultar a vista INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS para obter metadados em tempo real acerca das opções de projeto eficazes do BigQuery. Esta vista contém opções de configuração definidas ao nível da organização ou do projeto. Se a mesma opção de configuração for definida ao nível da organização e do projeto, é apresentado o valor da configuração 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 receber metadados de opções de projetos eficazes, precisa da autorização de gestão de identidade e de acesso (IAM).bigquery.config.get

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

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

A vista INFORMATION_SCHEMA.EFFECTIVE_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_SET_LEVEL STRING O nível na hierarquia no qual a definição é definida, com 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 predefinido em vigor para este projeto.
default_kms_key_name STRING O nome da chave predefinida em vigor para este projeto.
default_query_job_timeout_ms INT64 O tempo limite de consulta predefinido em milissegundos em vigor para este projeto.
default_interactive_query_queue_timeout_ms STRING O tempo limite predefinido efetivo em milissegundos para consultas interativas em fila para este projeto.
default_batch_query_queue_timeout_ms STRING O tempo limite predefinido efetivo em milissegundos para consultas em lote colocadas em fila para este projeto.
enable_reservation_based_fairness BOOL Use a equidade baseada em reservas em vez da equidade baseada em projetos.

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.EFFECTIVE_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, OPTION_VALUE, OPTION_SET_LEVEL e OPTION_SET_ON_ID da vista 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 é 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+