Vista ORGANIZATION_OPTIONS

Pode consultar a vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS para obter metadados em tempo real sobre as opções de organização do BigQuery. Esta vista contém opções de configuração definidas ao nível da organização. 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 da organização, precisa das seguintes autorizações de gestão de identidade e de acesso (IAM):

  • bigquery.config.get

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

  • 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.ORGANIZATION_OPTIONS, os resultados da consulta contêm uma linha para cada opção de configuração num projeto, se essa opção diferir do valor predefinido ao nível da organização.

A vista INFORMATION_SCHEMA.ORGANIZATION_OPTIONS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
OPTION_NAME STRING Um dos valores de nome na tabela de opções.
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 desta organização.
default_kms_key_name STRING O nome da chave predefinido para esta organização.
default_query_job_timeout_ms STRING O tempo limite da consulta predefinido em milissegundos para esta organização.
default_interactive_query_queue_timeout_ms STRING O tempo limite predefinido em milissegundos para consultas interativas em fila para esta organização.
default_batch_query_queue_timeout_ms STRING O tempo limite predefinido em milissegundos para consultas em lote na fila para esta organização.

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.ORGANIZATION_OPTIONS Opções de configuração na organização especificada. REGION

Substitua o seguinte:

Exemplos

O exemplo seguinte obtém as colunas OPTION_NAME, OPTION_TYPE e OPTION_VALUE de INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_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             |
  +--------------------------------------------+-------------+---------------------+