configurações de sessão enable_*

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

Ativa o algoritmo adaptativo de GROUP BY: cada thread agrega em sua tabela hash local até atingir adaptive_aggregator_freeze_threshold chaves (ou adaptive_aggregator_freeze_threshold_bytes de memória); então, a tabela é congelada, de modo que as linhas de chaves já vistas (frequentes) continuam sendo atualizadas nela, enquanto chaves novas (raras) são direcionadas pelo hash para filas por bucket e agregadas exatamente uma vez durante a mesclagem paralela por bucket. As chaves frequentes permanecem em pequenas tabelas residentes em cache, e as chaves raras são armazenadas e processadas uma vez, em vez de uma vez por thread.

As configurações de agregação externa (max_bytes_before_external_group_by, max_bytes_ratio_before_external_group_by) são respeitadas: depois de ultrapassar o limite, as filas são descarregadas antecipadamente na tabela compartilhada e, se isso não for suficiente para voltar a ficar abaixo do limite, a tabela compartilhada é gravada em disco por meio da agregação externa comum.

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

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.

Permite usar o codec de compressão experimental ALP.

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.

Habilita o otimizador de custo Cascades para planos de consultas distribuídas. Só tem efeito junto com make_distributed_plan = 1: isoladamente, a configuração não altera o planejamento de consultas em um único nó.

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

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.

Aliases: allow_experimental_full_text_index

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

Ativa a simplificação antecipada de constantes por curto-circuito para and e or durante a análise de consultas. Quando ativados, os ramos inativos qualificados de subconsultas escalares são analisados para preservar seus tipos e validar a semântica da consulta, mas não são executados. A otimização recorre à análise normal quando são necessários a cardinalidade escalar ou valores de tempo de execução.

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

Habilita a otimização de filtragem TopK durante a agregação em consultas GROUP BY keys ORDER BY <prefix of keys> LIMIT K e em consultas GROUP BY keys LIMIT K sem ORDER BY (nesse caso, quaisquer K grupos constituem um resultado válido; portanto, é sintetizada uma ordenação de todas as chaves).

Quando habilitada, o agregador mantém um heap limitado com as K principais chaves encontradas até o momento e deixa de inserir novas linhas na tabela hash quando a chave de agrupamento delas não pode fazer parte do resultado final. Isso evita agregar linhas que seriam descartadas pelo ORDER BY ... LIMIT subsequente e, quando o heap classifica a chave completa do GROUP BY, também remove os grupos expulsos da tabela hash intermediária, limitando seu tamanho ao LIMIT, em vez de ao número de chaves distintas. Quando o ORDER BY abrange apenas um prefixo próprio das chaves do GROUP BY, a classificação não consegue identificar um grupo completo; portanto, aplica-se apenas a omissão de linhas: a tabela hash mantém todos os grupos aceitos e ainda pode crescer conforme a cardinalidade das colunas de chave restantes.

A otimização é desabilitada quando o LIMIT solicitado é maior que query_plan_max_limit_for_top_k_optimization ou que o limite máximo de 100000, pois o custo de memória e CPU do heap cresce com o LIMIT solicitado.

A otimização é ignorada para estruturas de consulta em que remover grupos poderia alterar o resultado, incluindo WITH TOTALS, HAVING, QUALIFY, funções de janela, ROLLUP/CUBE/GROUPING SETS, LIMIT WITH TIES, um COLLATE em qualquer uma das chaves de GROUP BY correspondentes (um COLLATE em uma coluna posterior do ORDER BY, após o prefixo completo da chave, não pode afetar quais grupos se qualificam e, portanto, não desabilita a otimização), ORDER BY em um agregado ou em qualquer elemento que não seja um prefixo inicial das chaves de GROUP BY, e quando max_rows_to_group_by ou exact_rows_before_limit está definido.

Valores possíveis:

• 0 — Desabilitado.
• 1 — Habilitado.

Habilita a transformação do payload de um hash join em um layout orientado a linhas.

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.

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.

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.

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.

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", ...}

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.

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

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

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

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

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 │
└────┴────┴─────┘

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.

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.

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.

Permite usar o codec de compressão experimental Quantized.

Se ativado, os resultados de consultas SELECT são obtidos do cache de consultas.

Valores possíveis:

• 0 - Desabilitado
• 1 - Habilitado

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

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

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.

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.

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

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

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.

Permite usar o codec de compressão experimental SZ3.

Aliases: allow_experimental_time_time64_type

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

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.

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

Desativado por padrão.

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

Se estiver ativado, os resultados das consultas SELECT serão armazenados no cache de consultas.

Valores possíveis:

• 0 - Desabilitado
• 1 - Ativado

Permite usar o codec de compressão experimental ZXC.