Skip to main content
Estas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

​
allow_aggregate_partitions_independently

Habilita a agregação independente de partições em threads separadas quando a chave de particionamento é adequada à chave de GROUP BY. Isso é benéfico quando o número de partições é próximo do número de núcleos e as partições têm aproximadamente o mesmo tamanho. As heurísticas em ReadFromMergeTree desabilitam automaticamente a otimização para layouts desfavoráveis (poucas partições, muitas partições ou tamanhos de partição significativamente desbalanceados); consulte force_aggregate_partitions_independently para ignorar essas verificações.

​
allow_archive_path_syntax

Os motores File/S3 e a função de tabela analisarão caminhos com ’::’ como <archive> :: <file> se o arquivo tiver a extensão correta.

​
allow_asynchronous_read_from_io_pool_for_merge_tree

Usa o pool de E/S em segundo plano para ler dados de tabelas MergeTree. Essa configuração pode aumentar o desempenho de consultas limitadas por E/S.

​
allow_calculating_subcolumns_sizes_for_merge_tree_reading

Quando habilitada, o ClickHouse calculará o tamanho dos arquivos necessários para a leitura de cada subcoluna para melhorar o cálculo dos tamanhos das tarefas e dos blocos.

​
allow_changing_replica_until_first_data_packet

Se estiver habilitado, em hedged requests podemos iniciar uma nova conexão até receber o primeiro pacote de Data, mesmo que já tenhamos feito algum Progress (mas o Progress não tenha sido atualizado dentro do timeout receive_data_timeout); caso contrário, desabilitamos a troca de réplica depois da primeira vez em que houve Progress.

​
allow_create_index_without_type

Permite a consulta CREATE INDEX sem TYPE. A consulta será ignorada. Destinado a testes de compatibilidade com SQL.

​
allow_custom_error_code_in_throwif

Habilita o uso de código de erro personalizado na função throwIf(). Se true, as exceções lançadas podem ter códigos de erro inesperados.

​
allow_ddl

Se estiver definido como true, o usuário poderá executar consultas DDL.

​
allow_distributed_ddl

Se estiver definido como true, o usuário terá permissão para executar consultas de DDL distribuído.

​
allow_drop_detached

Permite consultas ALTER TABLE ... DROP DETACHED PART[ITION] ...

​
allow_dynamic_type_in_join_keys

Permite usar o tipo Dynamic em chaves de JOIN. Adicionado por compatibilidade. Não é recomendável usar o tipo Dynamic em chaves de JOIN, porque a comparação com outros tipos pode levar a resultados inesperados.

​
allow_execute_multiif_columnar

Permite executar a função multiIf de forma colunar

​
allow_fuzz_query_functions

Habilita a função fuzzQuery, que aplica mutações aleatórias de AST a uma string de consulta.

​
allow_general_join_planning

Permite um algoritmo de planejamento de join mais abrangente, capaz de lidar com condições mais complexas, mas que funciona apenas com hash join. Se o hash join não estiver habilitado, o algoritmo de planejamento de join padrão será usado independentemente do valor desta configuração.

​
allow_get_client_http_header

Permite usar a função getClientHTTPHeader, que permite obter o valor de um cabeçalho da requisição HTTP atual. Ela não é habilitada por padrão por motivos de segurança, pois alguns cabeçalhos, como Cookie, podem conter informações sensíveis. Observe que os cabeçalhos X-ClickHouse-*, Authentication e Authorization são sempre restritos e não podem ser obtidos com esta função.

​
allow_hyperscan

Permite funções que usam a biblioteca Hyperscan. Desative para evitar tempos de compilação potencialmente longos e uso excessivo de recursos.

​
allow_iceberg_remove_orphan_files

Permite usar ‘ALTER TABLE … EXECUTE remove_orphan_files()’ em tabelas Iceberg.

​
allow_insert_into_iceberg

Aliases: allow_experimental_insert_into_iceberg Permite executar consultas insert no Iceberg.

​
allow_introspection_functions

Habilita ou desabilita funções de introspecção para o perfilamento de consultas. Valores possíveis:
  • 1 — Funções de introspecção habilitadas.
  • 0 — Funções de introspecção desabilitadas.
Veja também

​
allow_key_condition_coalesce_rewrite

Permite que a chave primária e os índices de salto do MergeTree descartem grânulos para predicados WHERE/PREWHERE que envolvem coalesce ou ifNull. Sem essa configuração, esses predicados são opacos à análise de índices e não descartam grânulos, de modo que grânulos que não podem corresponder ainda são lidos. Isso afeta apenas quais grânulos são lidos; os resultados da consulta permanecem inalterados, porque as linhas ainda são filtradas pelo predicado original. Duas formas de predicado são reescritas antes da análise de índices:
  • Uma comparação com coalesce/ifNull, como coalesce(a, b) = 5, torna-se uma disjunção para que um índice em cada argumento possa descartar grânulos: a = 5 OR (a IS NULL AND b = 5), com extensão para mais argumentos.
  • Um coalesce/ifNull com uma constante padrão falsy (zero), usado diretamente como condição, como ifNull(a = 5, 0) ou coalesce(a = 5, 0), é reduzido ao predicado interno a = 5. Esses encapsulamentos colapsam o resultado ternário do predicado interno em um booleano definido (mapeando NULL para false).

​
allow_limit_by_partitions_independently

Habilita a avaliação independente de LIMIT BY em cada partição, em threads separadas, quando a expressão de partição é uma função determinística das colunas de LIMIT BY.

​
allow_materialized_view_with_bad_select

Permite CREATE MATERIALIZED VIEW com uma consulta SELECT que faz referência a tabelas ou colunas inexistentes. A consulta ainda precisa ser sintaticamente válida. Não se aplica a MVs atualizáveis. Não se aplica se o esquema da MV precisar ser inferido a partir da consulta SELECT (isto é, se o CREATE não tiver lista de colunas nem tabela de destino com TO). Pode ser usado para criar uma MV antes da tabela de origem.

​
allow_minmax_index_for_json

Permite criar índices skip minmax em colunas JSON (Object). Desativado por padrão porque o mecanismo de serialização do índice minmax não consegue lidar com os valores heterogêneos de Field que as colunas JSON podem conter.

​
allow_named_collection_override_by_default

Permite, por padrão, a substituição dos campos das coleções nomeadas.

​
allow_non_metadata_alters

Permite executar alters que afetam não apenas os metadados das tabelas, mas também os dados em disco

​
allow_nonconst_timezone_arguments

Permite argumentos de fuso horário não constantes em determinadas funções relacionadas a data e hora, como toTimeZone(), fromUnixTimestamp*() e snowflakeIDToDateTime*(). Essa configuração existe apenas por motivos de compatibilidade. No ClickHouse, o fuso horário é uma propriedade do tipo de dado e, por consequência, da coluna. Ativar essa configuração passa a impressão errada de que valores diferentes dentro de uma coluna podem ter fusos horários diferentes. Portanto, não ative essa configuração.

​
allow_nullable_tuple_in_extracted_subcolumns

Controla se subcolunas extraídas do tipo Tuple(...) podem ser tipadas como Nullable(Tuple(...)).
  • false: Retorna Tuple(...) e usa os valores padrão da tupla para linhas em que a subcoluna está ausente.
  • true: Retorna Nullable(Tuple(...)) e usa NULL para linhas em que a subcoluna está ausente.
Esta configuração controla apenas o comportamento das subcolunas extraídas. Ela não controla se colunas Nullable(Tuple(...)) podem ser criadas em tabelas; isso é controlado por enable_nullable_tuple_type. O ClickHouse usa o valor dessa configuração carregado na inicialização do servidor. Alterações feitas com SET ou SETTINGS no nível da consulta não mudam o comportamento das subcolunas extraídas. Para mudar o comportamento das subcolunas extraídas, atualize allow_nullable_tuple_in_extracted_subcolumns na configuração do perfil de inicialização (por exemplo, users.xml) e reinicie o servidor.

​
allow_rank_dense_rank_arguments

Permite passar argumentos para as funções de janela RANK e DENSE_RANK por compatibilidade retroativa. Segundo o padrão SQL, RANK e DENSE_RANK aceitam zero argumentos — elas classificam as linhas com base apenas na janela OVER (ORDER BY ...). Em versões do ClickHouse anteriores à 26.5, consultas como RANK(x) OVER (...) aceitavam e ignoravam silenciosamente o argumento, o que gerava confusão entre os usuários (o argumento visível sugeria que influenciava o ranking, mas não influenciava). Quando essa configuração é false (o padrão), RANK e DENSE_RANK rejeitam quaisquer argumentos e geram NUMBER_OF_ARGUMENTS_DOESNT_MATCH. Quando definida como true, o comportamento permissivo antigo é restaurado — os argumentos são ignorados silenciosamente, como acontecia antes da versão 26.5.

​
allow_reorder_prewhere_conditions

Permite reordenar as condições ao movê-las de WHERE para PREWHERE, para otimizar a filtragem

​
allow_replace_partition_from_empty_source

Permite que ALTER TABLE ... REPLACE PARTITION ... FROM ... remova silenciosamente a partição de destino quando a origem não tiver partes nessa partição. Por padrão, isso não é permitido: REPLACE PARTITION a partir de uma origem sem dados na partição solicitada gera uma exceção, porque, nesse caso, a operação efetivamente se torna um DROP PARTITION silencioso no destino (os dados do destino são removidos e nada os substitui), uma causa comum de perda acidental de dados (veja #23727). Ative essa configuração para restaurar o comportamento anterior, por exemplo, quando você usa intencionalmente uma partição de origem vazia para limpar dados no destino. Para uma remoção incondicional, prefira ALTER TABLE ... DROP PARTITION ....

​
allow_settings_after_format_in_insert

Controla se SETTINGS após FORMAT em consultas INSERT é permitido ou não. Não é recomendável usar isso, pois parte de SETTINGS pode ser interpretada como valores. Exemplo:
Mas a consulta a seguir só funcionará com allow_settings_after_format_in_insert:
Valores possíveis:
  • 0 — Não permitir.
  • 1 — Permitir.
Use esta configuração apenas por compatibilidade retroativa, caso seus casos de uso dependam da sintaxe antiga.

​
allow_simdjson

Permite o uso da biblioteca simdjson em funções ‘JSON*’ se as instruções AVX2 estiverem disponíveis. Se estiver desabilitado, a rapidjson será usada.

​
allow_special_serialization_kinds_in_output_formats

Permite a saída de colunas com tipos especiais de serialização, como Sparse e Replicated, sem convertê-las para a representação completa da coluna. Isso ajuda a evitar cópias de dados desnecessárias durante a formatação.

​
allow_unrestricted_reads_from_keeper

Permite leituras irrestritas (sem condição no path) da tabela system.zookeeper; pode ser útil, mas não é seguro para o ZooKeeper
Última modificação em 24 de julho de 2026