O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Gerenciar as configurações padrão

As definições de configuração padrão no BigQuery podem ajudar sua organização a aplicar a segurança, controlar custos e otimizar o desempenho das consultas. Como administrador do BigQuery ou proprietário do projeto, é possível especificar, remover e recuperar esses padrões nos níveis da organização e do projeto ou substituí-los em sessões e jobs individuais.

Funções exigidas

Para receber as permissões necessárias para especificar ou recuperar configurações de configuração, peça ao administrador que conceda a você os seguintes papéis do IAM:

Especificar as definições de configuração: Administrador do BigQuery (roles/bigquery.admin) na organização ou no projeto
Recuperar as definições de configuração: 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.

Esses papéis predefinidos contêm as permissões necessárias para especificar ou recuperar as definições de configuração. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para especificar ou recuperar as definições de configuração:

Especifique as definições de configuração: bigquery.config.update na organização ou no projeto
Recuperar as configurações: bigquery.config.get no projeto especificado

Essas permissões também podem ser concedidas com funções personalizadas 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

As configurações globais se aplicam a todos os locais e não usam um prefixo region-REGION.. Por outro lado, as configurações regionais se aplicam apenas a um local específico. É possível especificar configurações globais no nível da organização ou do projeto. O local padrão (default_location) é a única configuração global que você pode definir.

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

O local dos conjuntos de dados referenciados na solicitação. Por exemplo, se uma consulta fizer referência a uma tabela ou 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 com base nos recursos da 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.

Limitações

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

As configurações globais de organização e projeto não são compatíveis com os locais do BigQuery Omni. Não é possível definir default_location como um local do BigQuery Omni nem configurar ou visualizar as configurações globais em um local do BigQuery Omni.
Não é possível misturar configurações globais e regionais na mesma instrução DDL ALTER ORGANIZATION SET OPTIONS ou ALTER PROJECT SET OPTIONS.
Quando você modifica a configuração global default_location, a alteração pode levar até 10 minutos para ser propagada. Até que a configuração seja propagada, o BigQuery poderá encaminhar jobs que dependem do local padrão para o local padrão anterior.

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

É possível definir as configurações globais no nível da organização usando a instrução DDL ALTER ORGANIZATION SET OPTIONS. O local padrão (default_location) é a única configuração global que pode ser definida no nível da organização. Todas as outras configurações no nível da organização são regionais.

A instrução DDL ALTER ORGANIZATION SET OPTIONS se aplica à organização a que o projeto atual pertence.

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

Console

No console do Google Cloud , acesse a página do BigQuery.

Acessar o BigQuery
Para abrir o editor de consultas, clique em search_insights Consulta sem título.
Para definir a configuração default_location, insira a seguinte instrução DDL no editor de consultas:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Substitua LOCATION por uma região ou local multirregional do BigQuery. Esse valor é o local que o BigQuery usa para executar jobs quando o local do job não pode ser inferido da solicitação. Por exemplo, quando uma consulta não faz referência a conjuntos de dados ou conexões.
Como alternativa, para remover a configuração default_location no nível da organização, insira a seguinte instrução DDL no editor de consultas:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );
```
Clique em Executar.

bq

Para configurar a definição default_location no nível da organização, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Substitua LOCATION por uma região ou local multirregional do BigQuery. Esse valor é o local que o BigQuery usa para executar jobs quando não é possível inferir o local do job da solicitação, por exemplo, quando uma consulta não faz referência a nenhum conjunto de dados ou conexão.

Como alternativa, para remover a configuração default_location no nível da organização, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  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.

Configurar as configurações do projeto globais

É possível definir configurações globais no nível do projeto usando a instrução DDL ALTER PROJECT SET OPTIONS. O local padrão (default_location) é a única configuração global que pode ser definida no nível do projeto. Todas as outras configurações para envolvidos no projeto são configurações regionais.

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

As configurações para envolvidos no projeto substituem as da organização. Por sua vez, as configurações no nível da sessão podem substituir as configurações para envolvidos no projeto, e as configurações no nível do job podem substituir as configurações no nível da sessão.

Para configurar a opção default_location no nível do projeto, siga estas etapas:

Console

No console do Google Cloud , acesse a página do BigQuery.

Acessar o BigQuery
Para abrir o editor de consultas, clique em search_insights Consulta sem título.
Para definir a configuraçã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: uma região ou local multirregional do BigQuery. Esse valor é o local que o BigQuery usa para executar jobs quando o local do job não pode ser inferido da solicitação. Por exemplo, quando uma consulta não faz referência a conjuntos de dados ou conexões.
Como alternativa, para remover a configuração default_location no nível do projeto, insira a seguinte instrução DDL no editor de consultas:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
Se você remover a configuração default_location no nível do projeto, o BigQuery usará a configuração padrão no nível da organização, se houver, ou a configuração padrão do sistema.
Clique em Executar.

bq

Para configurar a definição default_location no nível do projeto, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Substitua:

PROJECT_ID: o ID do projeto;
LOCATION: uma região ou local multirregional do BigQuery. Esse valor é o local que o BigQuery usa para executar jobs quando o local do job não pode ser inferido da solicitação. Por exemplo, quando uma consulta não faz referência a conjuntos de dados ou conexões.

Como alternativa, para remover a configuração default_location no nível do projeto, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

Se você remover a configuração default_location no nível do projeto, o BigQuery vai usar a configuração padrão no nível da organização, se houver, ou a configuração padrão do sistema.

API

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

Especificar configurações regionais

As configurações regionais se aplicam a um local específico e exigem um prefixo region-REGION.. É possível configurar as definições regionais no nível da organização ou do projeto.

Controles de reserva e faturamento

É possível configurar definições regionais no nível do projeto para controlar como as consultas usam reservas ou faturamento sob demanda. Essas configurações ajudam a garantir a previsibilidade de custos, permitindo o uso flexível de reservas ou exigindo que as consultas usem slots de reserva.

Os controles comuns de reserva e faturamento incluem reservation_override_mode (pré-lançamento) e disable_on_demand_billing (pré-lançamento). Para definir essas configurações, consulte Definir configurações regionais do projeto. Para uma lista completa de opções de projeto, consulte a lista de opções do ALTER PROJECT SET OPTIONS.

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

É possível definir as 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.

Os exemplos nesta seção especificam as seguintes configurações padrão da organização regional:

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)
Armazenamento de tabelas e visualizações de índice da Pesquisa INFORMATION_SCHEMA (enable_info_schema_storage): ativado

Para mais informações sobre todas as configurações de organização regional, consulte organization_set_options_list.

Para definir as configurações regionais da organização, siga estas etapas:

Console

No console Google Cloud , acesse a página BigQuery.

Acessar o BigQuery
Para abrir o editor de consultas, clique em search_insights Consulta sem título.

Para definir as configuraçõ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,
  `region-REGION.enable_info_schema_storage` = true);

Substitua:

REGION: a região do BigQuery associada ao seu 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 remover as configurações regionais da organização, 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,
  `region-REGION.enable_info_schema_storage` = NULL);

Clique em Executar.

bq

Para configurar as configurações regionais da organização, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  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,
  `region-REGION.enable_info_schema_storage` = true);

Substitua:

REGION: a região do BigQuery 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 remover as configurações regionais da organização, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  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_info_schema_storage` = NULL);

API

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

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. É necessário especificar a região em que cada configuração de projeto é aplicada. Só é possível usar uma região em uma instrução.

A instrução DDL ALTER PROJECT SET OPTIONS aceita opcionalmente a variável PROJECT_ID. Se você não especificar PROJECT_ID, a instrução vai usar como padrão o projeto em que você executa a instrução DDL ALTER PROJECT.

Os exemplos nesta seção especificam as seguintes configurações padrão do projeto regional:

Fuso horário: America/Los_Angeles
Chave do Cloud KMS: uma chave definida pelo usuário
Tempo limite da consulta: 1 hora (3.600.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
Armazenamento de tabelas e visualizações de índice da Pesquisa INFORMATION_SCHEMA (enable_info_schema_storage): ativado

Para mais informações sobre todas as configurações regionais do projeto, consulte project_set_options_list.

Para configurar as configurações regionais do projeto, siga estas etapas:

Console

No console Google Cloud , acesse a página BigQuery.

Acessar o BigQuery
Para abrir o editor de consultas, clique em search_insights Consulta sem título.

Para definir 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` = '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,
 `region-REGION.enable_info_schema_storage` = true);

Substitua:

PROJECT_ID: o ID do projeto;
REGION: a região do BigQuery 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 remover 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,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

Clique em Executar.

bq

Para definir as configurações regionais do projeto, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  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,
  `region-REGION.enable_info_schema_storage` = true);

Substitua:

PROJECT_ID: o ID do projeto;
REGION: a região do BigQuery 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 remover as configurações regionais do projeto, insira o comando bq query com a flag --use_legacy_sql definida como false e forneça a seguinte instrução DDL como o parâmetro de consulta:

  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,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

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

Recuperar configurações

É possível ver as definições de configuração de uma organização ou de um projeto usando as seguintes visualizações 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.

As novas configurações podem levar alguns minutos para entrar em vigor e aparecer nas visualizações INFORMATION_SCHEMA.

Exemplos de consultas para recuperar configurações

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 ver todas as configurações globais da organização, execute a seguinte consulta:

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Para ver apenas a configuração da organização default_location, 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 ter acesso de visualização apenas à configuração efetiva de default_location do 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 default_location 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 padrão

As seções a seguir descrevem as definições de configuração 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 aguarda em uma fila de consultas. 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 aguarda em uma fila de consultas. Se não for definido, o padrão será de seis horas. O valor mínimo é 1 milissegundo, e o 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 só se aplica a jobs de consulta individuais e aos jobs filhos de scripts. Para definir um tempo limite para jobs de script, use o método de 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 configuração default_location é 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. Para mais informações, consulte Especificar locais.
enable_reservation_based_fairness: a opção que determina como os slots ociosos são compartilhados. Para projetos de administração criados após 10 de outubro de 2026, essa opção é ativada (TRUE) por padrão. Para projetos criados antes de 10 de outubro de 2026, o valor padrão é FALSE, o que significa que os slots ociosos são distribuídos igualmente entre todos os projetos de consulta. Se você ativar essa opção, os slots ociosos serão compartilhados igualmente entre todas as reservas primeiro e depois entre os projetos de cada 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 especificá-lo no nível da organização ou do job.
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. As consultas afetadas incluem aquelas que usam a palavra-chave DATETIME explícita, literais de string implicitamente convertidos transmitidos para funções de tempo, como DATETIME_DIFF('2022-10-01', ...), e a função PARSE_DATETIME(). Por esse motivo, é mais seguro definir a configuração default_time_zone apenas em novos projetos.
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. Mudar essa configuração não afeta o dialeto padrão no console. Essa opção pode ser uma das seguintes:
- 'default_legacy_sql' (padrão): use o SQL legado se o dialeto da 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 dialeto de consulta definido como SQL legado.
- NULL: use a configuração padrão do 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 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, independentemente do projeto em que são executadas.
reusable_column_aliases_mode: a opção que determina se os aliases de coluna reutilizáveis estão ativados para consultas. O valor padrão é off, o que significa que os aliases de coluna reutilizáveis não estão ativados. Para mais informações, consulte Aliases de coluna reutilizáveis.

Configurações de gerenciamento de dados

Use as configurações a seguir para definir regras de criação, segurança e ciclo de vida de 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_data_policy_projects: a lista padrão de projetos com políticas de dados avaliadas ao acessar colunas protegidas por tags de governança de dados. Por padrão, apenas as políticas de dados do projeto da tabela são avaliadas. Quando você configura um projeto de política de dados padrão no nível da organização, o BigQuery avalia as políticas de dados do projeto da tabela e as do projeto de política de dados padrão. Se houver políticas conflitantes nos dois projetos, as políticas de dados no projeto da tabela terão precedência. Só é possível definir essa configuração no nível da organização usando a instrução ALTER ORGANIZATION SET OPTIONS, por exemplo, region-us.default_data_policy_projects = ["my_default_project"]. Para mais informações, consulte Configurar um projeto de política de dados padrão.
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 saber como atribuir o papel de Criptografador/Descriptografador, consulte este link. Se você definir uma chave padrão do Cloud KMS sem atribuir os papéis apropriados, remova a chave padrão definindo o valor como NULL. Para ver exemplos, consulte Definir configurações regionais da organização e Definir configurações regionais 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.
enable_info_schema_storage: a opção que fornece acesso às visualizações INFORMATION_SCHEMA.TABLE_STORAGE e SEARCH_INDEXES e às variantes delas. Por padrão, essa opção não está ativada. Se você consultar essas visualizações pela primeira vez sem definir essa opção como TRUE, a consulta vai falhar e fornecer instruções para ativar a opção. Depois de ativar essa opção, as consultas são bem-sucedidas imediatamente e retornam dados gerados a partir desse momento. Um preenchimento completo de dados históricos pode levar aproximadamente um dia para ficar disponível nas visualizações. Se você usou essas visualizações antes da introdução dessa configuração, essa opção já está ativada.

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. Quando você usa conexões padrão, o BigQuery pode atualizar as permissões concedidas à conta de serviço da conexão, 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.
reservation_override_mode (pré-lançamento): especifica como as reservas de consulta podem ser substituídas na região (por exemplo, 'ALLOW_ANY_OVERRIDE'). Para mais detalhes, consulte a lista de opções ALTER PROJECT SET OPTIONS.
disable_on_demand_billing (pré-lançamento): determina se o faturamento on demand está desativado para consultas na região. Se true, todas as consultas precisarão usar uma reserva atribuída ou vão falhar. Para mais detalhes, consulte a lista de opções ALTER PROJECT SET OPTIONS.
preflight_fluid_autoscaling_reservations: a lista de reservas que aceitaram o escalonamento fluido para faturamento por segundo sem duração mínima. Para mais informações, consulte Entender as reservas.

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 do BigQuery.