configurações de sessão enable_*

Configurações de sessão do ClickHouse no grupo enable_* gerado.

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_json_ast_dialect

Habilite o valor clickhouse_json da configuração dialect.

Quando dialect é definido como clickhouse_json, as consultas são interpretadas como ASTs JSON (a saída de parseQueryToJSON) em vez de texto SQL. A consulta SET ainda é analisada como SQL puro, para que seja possível alternar o dialeto de volta.

Exemplo:

SET enable_json_ast_dialect = 1;
SET dialect = 'clickhouse_json';

-- Subsequent queries are parsed as JSON ASTs:
{"type":"SelectWithUnionQuery", ...}

​

enable_lazy_columns_replication

Habilita a replicação lazy de colunas em JOIN, ARRAY JOIN e capturas lambda de funções de ordem superior (por exemplo, arrayMap), 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_packed_string_keys_in_aggregation

Use uma tabela hash com referências compactadas a strings de 16 bytes (PackedStringRef) como chave em GROUP BY com uma única chave String não anulável. Chaves de até 11 bytes são armazenadas diretamente na referência compactada; chaves mais longas são referenciadas em uma arena. Esse método é mais rápido para a maioria das cargas de trabalho, mas pode ser mais lento que o método legado em GROUP BY com pouquíssimas chaves distintas com mais de 11 bytes (especialmente entre 12 e 24 bytes), pois a tabela hash legada mantém as chaves diretamente na célula, enquanto a compactada desreferencia o ponteiro da arena a cada sondagem. Quando desativado, é usado o método legado baseado em StringHashTable (o padrão antes da versão 26.8).

Todos os servidores que participam de uma consulta distribuída devem usar o mesmo valor: com distributed_aggregation_memory_efficient, os números dos buckets de dois níveis dependem do hash da chave, que difere entre os dois métodos. Portanto, servidores com configurações divergentes podem dividir a mesma chave em buckets diferentes e produzir um resultado mesclado incorretamente. Para garantir essa consistência, o iniciador sempre envia seu valor efetivo com as consultas secundárias (mesmo quando ele é proveniente apenas dos valores padrão do servidor/perfil), substituindo os próprios valores padrão dos servidores remotos.

​

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.

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