configurações de sessão enable_* - ClickHouse Documentation

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

enable_adaptive_memory_spill_scheduler

Faz o processador descarregar dados para o armazenamento externo de forma adaptativa. Atualmente, há suporte para grace join.

enable_add_distinct_to_in_subqueries

Habilita DISTINCT em subconsultas IN. Esta configuração envolve um trade-off: ao habilitá-la, é possível reduzir bastante o tamanho das tabelas temporárias transferidas em subconsultas distribuídas com IN e acelerar significativamente a transferência de dados entre shards, garantindo que apenas valores únicos sejam enviados. No entanto, habilitar essa configuração acrescenta esforço extra de mesclagem em cada nó, já que a desduplicação (DISTINCT) precisa ser executada. Use esta configuração quando a transferência pela rede for um gargalo e o custo adicional de mesclagem for aceitável.

enable_automatic_decision_for_merging_across_partitions_for_final

Se definido, o ClickHouse habilitará automaticamente essa otimização quando a expressão da chave de partição for determinística e todas as colunas usadas nela estiverem incluídas na chave primária. Essa derivação automática garante que linhas com os mesmos valores de chave primária sempre pertençam à mesma partição, tornando seguro evitar mesclagens entre partições.

enable_early_constant_folding

Habilita a otimização de consultas em que analisamos os resultados de funções e subconsultas e reescrevemos a consulta se houver constantes nelas.

enable_extended_results_for_datetime_functions

Habilita ou desabilita o retorno de resultados do tipo Date32 com faixa estendida (em comparação com o tipo Date) ou DateTime64 com faixa estendida (em comparação com o tipo DateTime). Valores possíveis:

0 — As funções retornam Date ou DateTime para todos os tipos de argumentos.
1 — As funções retornam Date32 ou DateTime64 para argumentos Date32 ou DateTime64, e Date ou DateTime nos demais casos.

A tabela abaixo mostra o comportamento dessa configuração em várias funções de data e hora.

Função	`enable_extended_results_for_datetime_functions = 0`	`enable_extended_results_for_datetime_functions = 1`
`toStartOfYear`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfISOYear`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfQuarter`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfMonth`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfWeek`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toLastDayOfWeek`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toLastDayOfMonth`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para valores de entrada `Date`/`DateTime` Retorna `Date32`/`DateTime64` para valores de entrada `Date32`/`DateTime64`
`toMonday`	Retorna `Date` ou `DateTime`	Retorna `Date`/`DateTime` para entradas `Date`/`DateTime` Retorna `Date32`/`DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfDay`	Retorna `DateTime` Observação: resultados incorretos para valores fora do intervalo de 1970 a 2149	Retorna `DateTime` para entradas `Date`/`DateTime` Retorna `DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfHour`	Retorna `DateTime` Observação: resultados incorretos para valores fora do intervalo de 1970 a 2149	Retorna `DateTime` para valores de entrada `Date`/`DateTime` Retorna `DateTime64` para valores de entrada `Date32`/`DateTime64`
`toStartOfFifteenMinutes`	Retorna `DateTime` Observação: resultados incorretos para valores fora do intervalo de 1970-2149	Retorna `DateTime` para `Date`/`DateTime` na entrada Retorna `DateTime64` para `Date32`/`DateTime64` na entrada
`toStartOfTenMinutes`	Retorna `DateTime` Nota: resultados incorretos para valores fora do intervalo de 1970-2149	Retorna `DateTime` para entradas `Date`/`DateTime` Retorna `DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfFiveMinutes`	Retorna `DateTime` Observação: resultados incorretos para valores fora do intervalo de 1970 a 2149	Retorna `DateTime` para entradas `Date`/`DateTime` Retorna `DateTime64` para entradas `Date32`/`DateTime64`
`toStartOfMinute`	Retorna `DateTime` Observação: resultados incorretos para valores fora do intervalo de 1970 a 2149	Retorna `DateTime` para entradas `Date`/`DateTime` Retorna `DateTime64` para entradas `Date32`/`DateTime64`
`timeSlot`	Retorna `DateTime` Nota: resultados incorretos para valores fora do intervalo de 1970 a 2149	Retorna `DateTime` para valores de entrada `Date`/`DateTime` Retorna `DateTime64` para valores de entrada `Date32`/`DateTime64`

enable_full_text_index

Aliases: allow_experimental_full_text_index Se definido como true, permite o uso do índice de texto.

enable_global_with_statement

Propagar instruções WITH para consultas UNION e todas as subconsultas

enable_hdfs_pread

Ativa ou desativa pread para arquivos HDFS. Por padrão, hdfsPread é usado. Se estiver desativado, hdfsRead e hdfsSeek serão usados para ler arquivos HDFS.

enable_http_compression

Ativa ou desativa a compressão de dados na resposta a uma requisição HTTP. Para mais informações, leia a descrição da interface HTTP. Valores possíveis:

0 — Desativado.
1 — Ativado.

enable_identifier_resolve_cache

Ativa o cache de resolução de identificadores no analisador de consultas. O cache compartilha nós de alias já resolvidos para evitar a explosão da AST quando o mesmo alias é referenciado várias vezes. Defina como false para desativar o cache se houver suspeita de resultados incorretos.

enable_job_stack_trace

Exibe o stack trace do criador de um job quando o job resulta em uma exceção. Desativado por padrão para evitar sobrecarga de desempenho.

enable_lazy_columns_replication

Habilita a replicação lazy de colunas em JOIN e ARRAY JOIN, evitando cópias desnecessárias das mesmas linhas várias vezes na memória.

enable_materialized_cte

Ativa expressões de tabela comuns materializadas; elas terão prioridade sobre enable_global_with_statement

enable_memory_bound_merging_of_aggregation_results

Habilita a estratégia de mesclagem com limite de memória para agregação.

enable_multiple_prewhere_read_steps

Move mais condições de WHERE para PREWHERE e execute leituras em disco e a filtragem em várias etapas se houver várias condições combinadas com AND

enable_named_columns_in_function_tuple

Gerar tuplas nomeadas na função tuple() quando todos os nomes forem únicos e puderem ser tratados como identificadores sem aspas.

enable_order_by_all

Ativa ou desativa a ordenação com a sintaxe ORDER BY ALL; consulte ORDER BY. Valores possíveis:

0 — Desativa ORDER BY ALL.
1 — Ativa ORDER BY ALL.

Exemplo Consulta:

CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();

INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM TAB ORDER BY ALL; -- returns an error that ALL is ambiguous

SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;

Resultado:

┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │  10 │
│ 30 │ 10 │  20 │
│ 10 │ 20 │  30 │
└────┴────┴─────┘

enable_parallel_blocks_marshalling

Afeta apenas consultas distribuídas. Se estiver habilitada, os blocos serão (de)serializados e (des)comprimidos nas threads do pipeline (ou seja, com paralelismo maior do que o padrão) antes/depois de serem enviados ao iniciador.

enable_parsing_to_custom_serialization

Se true, os dados podem ser convertidos diretamente para colunas com serialização personalizada (por exemplo, Sparse), de acordo com as indicações de serialização obtidas da tabela.

enable_producing_buckets_out_of_order_in_aggregation

Permite que a agregação com uso eficiente de memória (consulte distributed_aggregation_memory_efficient) produza buckets fora de ordem. Isso pode melhorar o desempenho quando os tamanhos dos buckets de agregação são desiguais, permitindo que uma réplica envie buckets com IDs mais altos ao nó iniciador enquanto ainda processa alguns buckets pesados com IDs mais baixos. A desvantagem é um uso de memória potencialmente maior.

enable_reads_from_query_cache

Se ativado, os resultados de consultas SELECT são obtidos do cache de consultas. Valores possíveis:

0 - Desabilitado
1 - Habilitado

enable_s3_requests_logging

Ativa um logging bem detalhado das requisições ao S3. Recomendado apenas para depuração.

enable_scalar_subquery_optimization

Se definido como true, evita que subconsultas escalares (de)serializem valores escalares grandes e pode evitar executar a mesma subconsulta mais de uma vez.

enable_scopes_for_with_statement

Se desabilitada, as declarações em cláusulas WITH pai terão o mesmo escopo de quando são declaradas no escopo atual. Observe que esta é uma configuração de compatibilidade para o analyzer, para permitir a execução de algumas consultas inválidas que o analyzer antigo conseguia executar.

enable_sharding_aggregator

Habilita a otimização de GROUP BY com sharding, que distribui linhas entre threads aplicando hash à chave de agrupamento, para que cada thread agregue um subconjunto distinto de chaves sem uma fase de merge. Isso é eficiente para chaves de alta cardinalidade com dados distribuídos de forma uniforme, mas pode ter desempenho ruim com distribuições de chaves muito desbalanceadas ou consultas com pouquíssimas chaves distintas. Valores possíveis:

0 — A otimização de agregação com sharding está desabilitada.
1 — A otimização de agregação com sharding está habilitada.

enable_shared_storage_snapshot_in_query

Se estiver habilitada, todas as subconsultas dentro de uma única consulta compartilharão o mesmo StorageSnapshot para cada tabela. Isso garante uma visão consistente dos dados em toda a consulta, mesmo se a mesma tabela for acessada várias vezes. Isso é necessário para consultas em que a consistência interna das partes de dados é importante. Exemplo:

SELECT
    count()
FROM events
WHERE (_part, _part_offset) IN (
    SELECT _part, _part_offset
    FROM events
    WHERE user_id = 42
)

Sem essa configuração, as consultas externa e interna podem operar em snapshots de dados diferentes, levando a resultados incorretos.

Ativar essa configuração desabilita a otimização que remove partes de dados desnecessárias dos snapshots após a conclusão da etapa de planejamento. Como resultado, consultas de longa duração podem reter partes obsoletas durante toda a execução, atrasando a limpeza dessas partes e aumentando a pressão sobre o armazenamento.No momento, essa configuração se aplica apenas a tabelas da família MergeTree.

Valores possíveis:

0 - Desativado
1 - Ativado

enable_sharing_sets_for_mutations

Permite o compartilhamento de objetos Set criados para subconsultas IN entre diferentes tarefas da mesma mutação. Isso reduz o uso de memória e o consumo de CPU

enable_streaming_queries

Permite consultas contínuas SELECT ... FROM t STREAM [CURSOR '{...}']. Quando desativado, qualquer expressão de tabela que use o modificador STREAM é rejeitada na compilação do plano. Esta é a configuração principal para o recurso de consultas de streaming; capacidades adicionais podem ser controladas por suas próprias configurações.

enable_time_time64_type

Aliases: allow_experimental_time_time64_type Permite a criação dos tipos de dados Time e Time64.

enable_unaligned_array_join

Permite ARRAY JOIN com vários arrays de tamanhos diferentes. Quando essa configuração está habilitada, os arrays serão redimensionados para o mais longo.

enable_url_encoding

Permite ativar/desativar a decodificação/codificação do caminho no URI em tabelas com o motor URL. Desativado por padrão.

enable_vertical_final

Se ativado, remove linhas duplicadas durante o FINAL marcando as linhas como excluídas e filtrando-as posteriormente, em vez de mesclar as linhas

enable_writes_to_query_cache

Se estiver ativado, os resultados das consultas SELECT serão armazenados no cache de consultas. Valores possíveis:

0 - Desativado
1 - Ativado

​enable_adaptive_memory_spill_scheduler

​enable_add_distinct_to_in_subqueries

​enable_automatic_decision_for_merging_across_partitions_for_final

​enable_early_constant_folding

​enable_extended_results_for_datetime_functions

​enable_full_text_index

​enable_global_with_statement

​enable_hdfs_pread

​enable_http_compression

​enable_identifier_resolve_cache

​enable_job_stack_trace

​enable_lazy_columns_replication

​enable_materialized_cte

​enable_memory_bound_merging_of_aggregation_results

​enable_multiple_prewhere_read_steps

​enable_named_columns_in_function_tuple

​enable_order_by_all

​enable_parallel_blocks_marshalling

​enable_parsing_to_custom_serialization

​enable_producing_buckets_out_of_order_in_aggregation

​enable_reads_from_query_cache

​enable_s3_requests_logging

​enable_scalar_subquery_optimization

​enable_scopes_for_with_statement

​enable_sharding_aggregator

​enable_shared_storage_snapshot_in_query

​enable_sharing_sets_for_mutations

​enable_streaming_queries

​enable_time_time64_type

​enable_unaligned_array_join

​enable_url_encoding

​enable_vertical_final

​enable_writes_to_query_cache

enable_adaptive_memory_spill_scheduler

enable_add_distinct_to_in_subqueries

enable_automatic_decision_for_merging_across_partitions_for_final

enable_early_constant_folding

enable_extended_results_for_datetime_functions

enable_full_text_index

enable_global_with_statement

enable_hdfs_pread

enable_http_compression

enable_identifier_resolve_cache

enable_job_stack_trace

enable_lazy_columns_replication

enable_materialized_cte

enable_memory_bound_merging_of_aggregation_results

enable_multiple_prewhere_read_steps

enable_named_columns_in_function_tuple

enable_order_by_all

enable_parallel_blocks_marshalling

enable_parsing_to_custom_serialization

enable_producing_buckets_out_of_order_in_aggregation

enable_reads_from_query_cache

enable_s3_requests_logging

enable_scalar_subquery_optimization

enable_scopes_for_with_statement

enable_sharding_aggregator

enable_shared_storage_snapshot_in_query

enable_sharing_sets_for_mutations

enable_streaming_queries

enable_time_time64_type

enable_unaligned_array_join

enable_url_encoding

enable_vertical_final

enable_writes_to_query_cache