Gerenciar configurações

Os administradores do BigQuery e os proprietários de projetos podem gerenciar as configurações no nível da organização e do projeto. É possível definir configurações para aplicar a segurança, controlar os custos e otimizar o desempenho das consultas em toda a infraestrutura de dados. Ao definir valores padrão, é possível garantir conformidade e eficiência operacional consistentes, facilitando o gerenciamento do ambiente do BigQuery.

As seções a seguir descrevem como especificar as configurações de configuração padrão. As configurações padrão são definidas no nível da organização ou do projeto, mas podem ser substituídas no nível da sessão ou do job.

Funções exigidas

Para ter a permissão necessária para especificar uma configuração, peça ao administrador para conceder a você o papel do IAM de Administrador do BigQuery (roles/bigquery.admin). Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão bigquery.config.update, que é necessária para especificar uma configuração.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre os papéis e as permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.

Especificar configurações globais

É possível especificar configurações globais no nível da organização ou do projeto.

Limitações

As configurações globais estão sujeitas às seguintes limitações:

As configurações globais de organização e projeto não estão disponíveis nos locais do BigQuery Omni.
Quando você modifica a configuração global default_location, pode levar até 10 minutos para que ela seja propagada. Até que a configuração seja propagada, é possível que consultas qualificadas sejam encaminhadas para o local padrão anterior.

Configurar as configurações globais da organização

Se você não especificar um local, ele será determinado de uma das seguintes maneiras:

O local dos conjuntos de dados referenciados na solicitação. Por exemplo, se uma consulta referenciar uma tabela ou uma visualização em um conjunto de dados armazenado na região asia-northeast1, o job de consulta será executado em asia-northeast1.
A região especificada para uma conexão referenciada em uma solicitação.
O local de uma tabela de destino.

Se o local não for especificado explicitamente e não puder ser determinado pelos recursos na solicitação, o local padrão será usado. Se o local padrão não estiver definido, o job será executado na multirregião US.

É possível definir configurações globais no nível da organização usando a instrução DDL ALTER ORGANIZATION SET OPTIONS. O local padrão é a única configuração global da organização. O local padrão é usado para executar jobs quando não é possível inferir o local da solicitação.

Ao configurar o local padrão, você não especifica uma região em que a configuração é aplicada. Não é possível misturar configurações globais e regionais na mesma instrução DDL.

Para configurar o default_location no nível da organização, siga estas etapas:

Console

Acesse a página do BigQuery no console Google Cloud .

Acessar o BigQuery
Clique no editor de consultas. Essa guia é chamada de search_insights Consulta sem título.
Para configurar o default_location, insira a seguinte instrução DDL no Editor de consultas:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION');
```
Substitua LOCATION por um local regional ou multirregional. Esse valor é o local usado para executar jobs quando não é possível inferir do pedido. Por exemplo, o local padrão é usado se não for possível determinar o local dos conjuntos de dados em uma consulta.
Como alternativa, para limpar as configurações globais no nível da organização default_location, insira a seguinte instrução DDL no Editor de consultas:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL);
```
Clique em Executar.

bq

Para configurar o default_location no nível da organização, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a flag use_legacy_sql como false.
```
  bq query --use_legacy_sql=false \
  'ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION');'
```
Substitua LOCATION por um local regional ou multirregional. Esse valor é o local usado para executar jobs quando não é possível inferir da solicitação. Por exemplo, o local padrão é usado se não for possível determinar o local dos conjuntos de dados em uma consulta.
Para limpar o default_location no nível da organização, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a flag use_legacy_sql como false.
```
  bq query --use_legacy_sql=false \
  'ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL);'
```

API

Chame o método jobs.query e forneça a instrução DDL na propriedade query do corpo da solicitação.

A funcionalidade DDL amplia as informações retornadas por um recurso de jobs. statistics.query.statementType inclui os seguintes valores extras:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query tem dois campos extras:

ddlOperationPerformed: a operação DDL realizada, possivelmente dependente da existência do destino DDL. Os valores atuais incluem:
- CREATE: a consulta criou o destino DDL.
- SKIP: exemplos de ambiente autônomo: CREATE TABLE IF NOT EXISTS foi enviado e a tabela existe. Ou DROP TABLE IF EXISTS foi enviado e a tabela não existe.
- REPLACE: a consulta substituiu o destino DDL. Exemplo: CREATE OR REPLACE TABLE foi enviado e a tabela já existe.
- DROP: a consulta excluiu o destino DDL.
ddlTargetTable: quando você envia uma instrução CREATE TABLE/VIEW ou DROP TABLE/VIEW, a tabela de destino é retornada como um objeto com três campos:

"projectId": string
"datasetId": string
"tableId": string

Configurar as configurações do projeto globais

Se você não especificar um local, ele será determinado de uma das seguintes maneiras:

O local dos conjuntos de dados referenciados na solicitação. Por exemplo, se uma consulta referenciar uma tabela ou uma visualização em um conjunto de dados armazenado na região asia-northeast1, o job de consulta será executado em asia-northeast1.
A região especificada para uma conexão referenciada em uma solicitação.
O local de uma tabela de destino.

É possível definir configurações globais no nível do projeto usando a instrução DDL ALTER PROJECT SET OPTIONS. A instrução DDL ALTER PROJECT SET OPTIONS aceita opcionalmente a variável PROJECT_ID. Se o PROJECT_ID não for especificado, o padrão será o projeto atual em que você executa a instrução DDL ALTER PROJECT.

O local padrão é a única configuração global do projeto. Ao configurar o local padrão, você não especifica uma região em que a configuração é aplicada. Não é possível misturar configurações globais e regionais na mesma instrução DDL.

As configurações no nível do projeto modificam as da organização. As configurações para envolvidos no projeto podem ser substituídas por configurações no nível da sessão, que podem ser substituídas por configurações no nível do job.

Para configurar o default_location no nível do projeto, siga estas etapas:

Console

Acesse a página do BigQuery no console Google Cloud .

Acessar o BigQuery
Clique no editor de consultas. Essa guia é chamada de search_insights Consulta sem título.
Para configurar o default_location, insira a seguinte instrução DDL no Editor de consultas:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION');
```
Substitua:
- PROJECT_ID: o ID do projeto;
- LOCATION: um local regional ou multirregional. Esse valor é o local usado para executar jobs quando não é possível inferir do pedido. Por exemplo, o local padrão é usado se não for possível determinar o local dos conjuntos de dados em uma consulta.
Como alternativa, para limpar a configuração default_location, insira a seguinte instrução DDL no Editor de consultas. Se você limpar o default_location no nível do projeto, serão usadas as configurações padrão no nível da organização, se houver. Caso contrário, a configuração padrão do sistema será usada.
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL);
```
Clique em Executar.

bq

Para configurar o default_location no nível do projeto, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a flag use_legacy_sql como false.
```
  bq query --use_legacy_sql=false \
  'ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION');'
```
Substitua:
- PROJECT_ID: o ID do projeto;
- LOCATION: um local regional ou multirregional. Esse valor é o local usado para executar jobs quando não é possível inferir do pedido. Por exemplo, o local padrão é usado se não for possível determinar o local dos conjuntos de dados em uma consulta.
Como alternativa, para limpar o default_location no nível do projeto, insira o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a flag use_legacy_sql como false. Se você desmarcar a opção default_location no nível do projeto, as configurações padrão da organização serão usadas, se houver. Caso contrário, a configuração padrão do sistema será usada.
```
  bq query --use_legacy_sql=false \
  'ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL);'
```

API

Chame o método jobs.query e forneça a instrução DDL na propriedade query do corpo da solicitação.

A funcionalidade DDL amplia as informações retornadas por um recurso de jobs. statistics.query.statementType inclui os seguintes valores extras:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query tem dois campos extras:

ddlOperationPerformed: a operação DDL realizada, possivelmente dependente da existência do destino DDL. Os valores atuais incluem:
- CREATE: a consulta criou o destino DDL.
- SKIP: exemplos de ambiente autônomo: CREATE TABLE IF NOT EXISTS foi enviado e a tabela existe. Ou DROP TABLE IF EXISTS foi enviado e a tabela não existe.
- REPLACE: a consulta substituiu o destino DDL. Exemplo: CREATE OR REPLACE TABLE foi enviado e a tabela já existe.
- DROP: a consulta excluiu o destino DDL.
ddlTargetTable: quando você envia uma instrução CREATE TABLE/VIEW ou DROP TABLE/VIEW, a tabela de destino é retornada como um objeto com três campos:

"projectId": string
"datasetId": string
"tableId": string

Especificar configurações regionais

É possível configurar as configurações regionais no nível da organização ou do projeto.

Configurar as configurações regionais da organização

É possível definir configurações regionais no nível da organização usando a instrução DDL ALTER ORGANIZATION SET OPTIONS. É necessário especificar a região em que cada configuração da organização é aplicada. Só é possível usar uma região em uma instrução.

Para configurar as configurações regionais da organização, siga estas etapas. O exemplo a seguir especifica várias configurações regionais padrão, incluindo as seguintes:

Fuso horário: America/Chicago
Chave do Cloud KMS: uma chave definida pelo usuário
Tempo limite da consulta: 30 minutos (1.800.000 milissegundos)
Tempo limite da fila de consultas interativas: 10 minutos (600.000 milissegundos)
Tempo limite da fila de consultas em lote: 20 minutos (1.200.000 milissegundos)

Para ver todas as configurações de organização regional, acesse organization_set_options_list.

Console

Acesse a página do BigQuery no console Google Cloud .

Acessar o BigQuery
Clique no editor de consultas. Essa guia é chamada de search_insights Consulta sem título.

Para configurar as opções regionais da organização, insira a seguinte instrução DDL no Editor de consultas:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000);

Substitua:

REGION: a região associada ao projeto ou à organização. Por exemplo, us ou europe-west6. O valor de REGION precisa ser o mesmo para cada opção no comando.
KMS_KEY: uma chave do Cloud KMS definida pelo usuário. Para mais informações, consulte Chaves do Cloud KMS gerenciadas pelo cliente.

Como alternativa, para limpar as configurações da organização regional, insira a seguinte instrução DDL no Editor de consultas:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL);

Clique em Executar.

bq

Para configurar as configurações regionais da organização, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a sinalização use_legacy_sql como false.

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000);

Substitua:

REGION: a região associada ao projeto ou à organização. Por exemplo, us ou europe-west6. O valor de REGION precisa ser o mesmo para cada opção no comando.
KMS_KEY: uma chave do Cloud KMS definida pelo usuário. Para mais informações, consulte Chaves do Cloud KMS gerenciadas pelo cliente.

Como alternativa, para limpar as configurações regionais da organização, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a flag use_legacy_sql como false:

ALTER ORGANIZATION
SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.default_storage_billing_model`= NULL,
  `region-REGION.default_max_time_travel_hours` = NULL,
  `region-REGION.default_cloud_resource_connection_id` = NULL,
  `region-REGION.default_sql_dialect_option` = NULL,
  `region-REGION.enable_reservation_based_fairness` = NULL,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL);

API

Chame o método jobs.query e forneça a instrução DDL na propriedade query do corpo da solicitação.

A funcionalidade DDL amplia as informações retornadas por um recurso de jobs. statistics.query.statementType inclui os seguintes valores extras:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query tem dois campos extras:

ddlOperationPerformed: a operação DDL realizada, possivelmente dependente da existência do destino DDL. Os valores atuais incluem:
- CREATE: a consulta criou o destino DDL.
- SKIP: exemplos de ambiente autônomo: CREATE TABLE IF NOT EXISTS foi enviado e a tabela existe. Ou DROP TABLE IF EXISTS foi enviado e a tabela não existe.
- REPLACE: a consulta substituiu o destino DDL. Exemplo: CREATE OR REPLACE TABLE foi enviado e a tabela já existe.
- DROP: a consulta excluiu o destino DDL.
ddlTargetTable: quando você envia uma instrução CREATE TABLE/VIEW ou DROP TABLE/VIEW, a tabela de destino é retornada como um objeto com três campos:

"projectId": string
"datasetId": string
"tableId": string

Configurar as definições regionais do projeto

É possível definir as configurações regionais no nível do projeto usando a instrução DDL ALTER PROJECT SET OPTIONS. Ao especificar a configuração, é necessário informar a região em que ela será aplicada. Só é possível usar uma região em cada instrução.

A instrução DDL ALTER PROJECT SET OPTIONS aceita opcionalmente a variável PROJECT_ID. Se a variável PROJECT_ID não for especificada, o padrão será o projeto atual em que você executa a instrução DDL ALTER PROJECT.

O exemplo a seguir especifica várias configurações regionais e para envolvidos no projeto, incluindo:

Fuso horário: America/Los_Angeles
Chave do Cloud KMS: um exemplo de chave
Tempo limite da consulta: 1 hora (1.800.000 milissegundos)
Tempo limite da fila de consultas interativas: 10 minutos (600.000 milissegundos)
Tempo limite da fila de consultas em lote: 20 minutos (1.200.000 milissegundos)
Imparcialidade baseada em reservas: ativada
Consultas globais: ativadas para execução e acesso a dados

Para ver todas as configurações regionais do projeto, acesse project_set_options_list.

Console

Acesse a página do BigQuery no console Google Cloud .

Acessar o BigQuery
Clique no editor de consultas. Essa guia é chamada de search_insights Consulta sem título.

Para configurar as definições do projeto regional, insira a seguinte instrução DDL no Editor de consultas:

 ALTER PROJECT PROJECT_ID
 SET OPTIONS (
 `region-REGION.default_time_zone` = 'America/Los_Angeles',
 -- Ensure all service accounts under the project have permission to KMS_KEY
 `region-REGION.default_kms_key_name` = KMS_KEY,
 `region-REGION.default_query_job_timeout_ms` = 3600000,
 `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
 `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
 `region-REGION.enable_reservation_based_fairness` = true,
`region-REGION.enable_global_queries_execution` = true,
`region-REGION.enable_global_queries_data_access` = true);

Substitua:

PROJECT_ID: o ID do projeto;
REGION: a região associada ao projeto ou à organização. Por exemplo, us ou europe-west6. O valor de REGION precisa ser o mesmo para cada opção no comando.
KMS_KEY: uma chave do Cloud KMS definida pelo usuário. Para mais informações, consulte Chaves do Cloud KMS gerenciadas pelo cliente.

Como alternativa, para limpar as configurações regionais do projeto, insira a seguinte instrução DDL no Editor de consultas:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false);

Clique em Executar.

bq

Para configurar as configurações regionais do projeto, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a sinalização use_legacy_sql como false.

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_reservation_based_fairness` = true);

Substitua:

PROJECT_ID: o ID do projeto;
REGION: a região associada ao projeto ou à organização. Por exemplo, us ou europe-west6. O valor de REGION precisa ser o mesmo para cada opção no comando.
KMS_KEY: uma chave do Cloud KMS definida pelo usuário. Para mais informações, consulte Chaves do Cloud KMS gerenciadas pelo cliente.

Como alternativa, para limpar as configurações do projeto regional, digite o comando bq query e forneça a seguinte instrução DDL como o parâmetro de consulta. Defina a flag use_legacy_sql como false:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
`region-REGION.enable_global_queries_execution` = NULL,
`region-REGION.enable_global_queries_data_access` = NULL);

API

Chame o método jobs.query e forneça a instrução DDL na propriedade query do corpo da solicitação.

A funcionalidade DDL amplia as informações retornadas por um recurso de jobs. statistics.query.statementType inclui os seguintes valores extras:

CREATE_TABLE
CREATE_TABLE_AS_SELECT
DROP_TABLE
CREATE_VIEW
DROP_VIEW

statistics.query tem dois campos extras:

ddlOperationPerformed: a operação DDL realizada, possivelmente dependente da existência do destino DDL. Os valores atuais incluem:
- CREATE: a consulta criou o destino DDL.
- SKIP: exemplos de ambiente autônomo: CREATE TABLE IF NOT EXISTS foi enviado e a tabela existe. Ou DROP TABLE IF EXISTS foi enviado e a tabela não existe.
- REPLACE: a consulta substituiu o destino DDL. Exemplo: CREATE OR REPLACE TABLE foi enviado e a tabela já existe.
- DROP: a consulta excluiu o destino DDL.
ddlTargetTable: quando você envia uma instrução CREATE TABLE/VIEW ou DROP TABLE/VIEW, a tabela de destino é retornada como um objeto com três campos:

"projectId": string
"datasetId": string
"tableId": string

Recuperar configurações

É possível conferir as configurações de uma organização ou projeto usando as seguintes visualizações do INFORMATION_SCHEMA:

INFORMATION_SCHEMA.PROJECT_OPTIONS: as configurações aplicadas a um projeto.
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS: as configurações efetivas aplicadas a um projeto. As configurações efetivas incluem todas aquelas definidas para envolvidos no projeto e todas aquelas herdadas pelo projeto de uma organização.
INFORMATION_SCHEMA.ORGANIZATION_OPTIONS: as configurações aplicadas a uma organização.

Pode levar alguns minutos para que as novas configurações entrem em vigor e sejam refletidas na visualização INFORMATION_SCHEMA.

Funções exigidas

Para ter a permissão necessária para recuperar as configurações, peça ao administrador para conceder a você o papel do IAM de Usuário de jobs do BigQuery (roles/bigquery.jobUser) no projeto especificado. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão bigquery.config.get, que é necessária para recuperar as configurações de configuração.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre os papéis e as permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.

Exemplos

Use os exemplos de consulta a seguir para recuperar as configurações do projeto e da organização das visualizações do INFORMATION_SCHEMA.

Ver as configurações globais

Para conferir todas as configurações globais da organização, execute a seguinte consulta:

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Para ver apenas a configuração de local padrão da organização, execute a seguinte consulta:

SELECT
    option_value
FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS
WHERE option_name = 'default_location'

Para conferir todas as configurações globais efetivas do projeto padrão, execute a seguinte consulta:

SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Para ver apenas a configuração global efetiva do local padrão do seu projeto padrão, execute a seguinte consulta:

SELECT
    option_value
FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
WHERE option_name = 'default_location'

Para conferir todas as configurações globais do projeto padrão, execute a seguinte consulta:

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

Para ver apenas a configuração de local padrão do projeto padrão, execute a seguinte consulta:

SELECT
    option_value
FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
WHERE option_name = 'default_location'

Ver configurações regionais

Para ver as configurações em uma organização na região us, execute a seguinte consulta:

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Para ver as configurações efetivas no projeto padrão na região us, execute a seguinte consulta:

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Para ver as configurações no projeto padrão na região us, execute a seguinte consulta:

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Configurações

As seções a seguir descrevem as configurações que podem ser especificadas.

Configurações de execução de consultas e jobs

Use as configurações a seguir para controlar como as consultas são executadas, cronometradas e enfileiradas.

default_batch_query_queue_timeout_ms: o tempo padrão, em milissegundos, que uma consulta em lote fica na fila. Quando não está definido, o padrão é 24 horas. O valor mínimo é 1 milissegundo. O valor máximo é 48 horas. Para desativar o enfileiramento de consultas em lote, defina o valor como -1.
default_interactive_query_queue_timeout_ms: o tempo padrão, em milissegundos, que uma consulta interativa fica na fila. Quanto não está definido, o padrão é seis horas. O valor mínimo é 1 milissegundo. O valor máximo é 48 horas. Para desativar o enfileiramento de consultas interativas, defina o valor como -1.
default_query_job_timeout_ms: o tempo padrão após o qual um job de consulta expira, incluindo o tempo do job na fila e o tempo gasto na execução. O tempo limite precisa ser de 5 minutos a 48 horas. Esse tempo limite se aplica apenas a jobs de consulta individuais e aos jobs filhos de scripts. Para definir um tempo limite para jobs de script, use o método da API jobs.insert e defina o campo jobTimeoutMs.

Observação: a configuração default_query_job_timeout_ms também se aplica a jobs de consulta contínua. Para substituir essa configuração no nível do projeto em uma consulta contínua específica, atribua um tempo limite de job à consulta contínua em questão. As consultas contínuas ainda obedecem aos tempos máximos de execução.
default_location: a default_location configuração é usada para executar jobs quando o local não está definido ou não pode ser determinado. Se default_location não estiver definido, o job será executado na multirregião US.
enable_reservation_based_fairness: a opção que determina como os slots ociosos são compartilhados. O valor padrão é "false", o que significa que os slots ociosos são distribuídos igualmente entre todos os projetos de consulta. Se ativado, os slots ociosos serão compartilhados igualmente entre todas as reservas primeiro e, depois, entre os projetos dentro da reserva. Para mais informações, consulte imparcialidade baseada em reservas. Essa opção é compatível apenas no nível do projeto. Não é possível especificar no nível da organização ou do trabalho.
default_time_zone: o fuso horário padrão a ser usado em funções do GoogleSQL dependentes de fuso horário, quando um fuso horário não é especificado como um argumento. Essa configuração não se aplica a tabelas particionadas por coluna de unidade de tempo (que usam UTC como fuso horário), transferências programadas do Serviço de transferência do Cloud Storage ou carregamento de dados com a ferramenta de linha de comando bq. Para mais informações, consulte Fusos horários.

Observação: se você quiser definir um fuso horário padrão, garanta que as consultas atuais que usam literais DATETIME não sejam afetadas. Isso inclui consultas com a palavra-chave DATETIME explícita, literais de string implicitamente convertidos transmitidos como parâmetros para funções de tempo como DATETIME_DIFF('2022-10-01', ...), a função PARSE_DATETIME() e mais. Por esse motivo, é mais seguro definir apenas o parâmetro default_time_zone em projetos novos.
default_query_optimizer_options: as otimizações de consulta baseadas no histórico. Essa opção pode ser:
- 'adaptive=on': use otimizações de consulta baseadas no histórico.
- 'adaptive=off': não use otimizações de consulta baseadas no histórico.
- NULL (padrão): use as otimizações de consulta baseadas no histórico padrão, que é equivalente a 'adaptive=on'.
default_sql_dialect_option: o dialeto de consulta SQL padrão para executar jobs de consulta usando a ferramenta de linha de comando bq ou a API BigQuery. Alterar essa configuração não afeta o dialeto padrão no console. Essa opção pode ser:
- 'default_legacy_sql' (padrão): usa o SQL legado se o dialeto de consulta não for especificado no nível do job.
- 'default_google_sql': use o GoogleSQL se o dialeto de consulta não for especificado no nível do job.
- 'only_google_sql': use o GoogleSQL se o dialeto de consulta não for especificado no nível do job. Rejeitar jobs com o dialeto de consulta definido como SQL legado.
- NULL: use a configuração padrão de dialeto de consulta, que é equivalente a 'default_legacy_sql'.
enable_global_queries_execution: a opção que determina se as consultas globais podem ser executadas. O valor padrão é FALSE, o que significa que as consultas globais não estão ativadas.
enable_global_queries_data_access: a opção que determina se as consultas globais podem acessar os dados armazenados na região. O valor padrão é FALSE, o que significa que as consultas globais não podem copiar dados dessa região, seja qual for o projeto em que são executadas.

Configurações de gerenciamento de dados

Use as configurações a seguir para definir regras para criação, segurança e ciclo de vida dos dados.

default_column_name_character_map: o escopo e o processamento padrão de caracteres em nomes de colunas. Se não for definido, os jobs de carregamento que usam caracteres incompatíveis nos nomes de colunas vão apresentar falha com uma mensagem de erro. Algumas tabelas mais antigas podem ser definidas para substituir caracteres não compatíveis nos nomes das colunas. Para mais informações, consulte load_option_list.
default_kms_key_name: a chave padrão do Cloud Key Management Service para criptografar dados de tabela, incluindo tabelas temporárias ou anônimas. Para mais informações, consulte Chaves do Cloud KMS gerenciadas pelo cliente.

Observação: para definir uma chave padrão do Cloud KMS, conceda o papel de criptografador/descriptografador a todas as contas de serviço do BigQuery usadas no projeto ou na organização. Se uma conta de serviço no projeto ou na organização não tiver as permissões apropriadas, todas as consultas executadas por ela vão falhar. Para informações sobre como atribuir o papel de criptografador/descriptografador, consulte Atribuir o papel de criptografador/descriptografador. Se você definir uma chave padrão do Cloud KMS sem atribuir os papéis apropriados, limpe a chave padrão definindo o valor como NULL. Para ver exemplos, consulte Definir configurações da organização e Definir configurações do projeto.
default_max_time_travel_hours: a janela de viagem no tempo padrão em horas para novos conjuntos de dados. Essa duração precisa estar no intervalo de 48 a 168, inclusive, e ser divisível por 24. Mudar o tempo máximo de viagem padrão não afeta os conjuntos de dados atuais. Para mais informações, consulte Viagem no tempo e retenção de dados.

Configurações de custo e recursos

Use as configurações a seguir para determinar como os recursos são faturados e conectados.

default_storage_billing_model: o modelo de faturamento de armazenamento padrão para os novos conjuntos de dados. Defina o valor como PHYSICAL para usar bytes físicos ao calcular as cobranças de armazenamento ou como LOGICAL para usar bytes lógicos. A alteração do modelo de faturamento padrão de armazenamento não afeta os conjuntos de dados atuais. Para mais informações, consulte Modelos de faturamento do Storage.
default_cloud_resource_connection_id: a conexão padrão a ser usada ao criar tabelas e modelos. Especifique apenas o ID ou o nome da conexão e exclua os prefixos de ID do projeto e região anexados. O uso de conexões padrão pode fazer com que as permissões concedidas à conta de serviço da conexão sejam atualizadas, dependendo do tipo de tabela ou modelo que você está criando. Para mais informações, consulte a Visão geral da conexão padrão.

Preços

Não há cobrança adicional por usar o serviço de configuração do BigQuery. Para mais informações, consulte Preços.