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

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

distributed_aggregation_memory_efficient

Indica se o modo de economia de memória da agregação distribuída está habilitado.

distributed_connections_pool_size

O número máximo de conexões simultâneas com servidores remotos para o processamento distribuído de todas as consultas em uma única tabela distribuída. Recomendamos definir um valor não menor que o número de servidores no cluster.

distributed_foreground_insert

Aliases: insert_distributed_sync Habilita ou desabilita a inserção síncrona de dados em uma tabela distribuída. Por padrão, ao inserir dados em uma tabela Distributed, o servidor ClickHouse envia os dados para os nós do cluster em segundo plano. Quando distributed_foreground_insert=1, os dados são processados de forma síncrona, e a operação INSERT só é concluída com sucesso depois que todos os dados são salvos em todos os shards (pelo menos uma réplica para cada shard se internal_replication for true). Valores possíveis:

0 — Os dados são inseridos em segundo plano.
1 — Os dados são inseridos em modo síncrono.

Valor padrão no Cloud: 1. Veja também

distributed_group_by_no_merge

Não mescla estados de agregação de diferentes servidores no processamento distribuído de consultas. Você pode usar isso quando for certo que há chaves diferentes em shards diferentes. Possíveis valores:

0 — Desabilitado (o processamento final da consulta é feito no nó iniciador).
1 - Não mescla estados de agregação de diferentes servidores no processamento distribuído de consultas (a consulta é processada completamente no shard, e o iniciador apenas atua como proxy dos dados); pode ser usado quando for certo que há chaves diferentes em shards diferentes.
2 - Igual a 1, mas aplica ORDER BY e LIMIT no iniciador (isso não é possível quando a consulta é processada completamente no nó remoto, como em distributed_group_by_no_merge=1); pode ser usado para consultas com ORDER BY e/ou LIMIT.

Exemplo

SELECT *
FROM remote('127.0.0.{2,3}', system.one)
GROUP BY dummy
LIMIT 1
SETTINGS distributed_group_by_no_merge = 1
FORMAT PrettyCompactMonoBlock

┌─dummy─┐
│     0 │
│     0 │
└───────┘

SELECT *
FROM remote('127.0.0.{2,3}', system.one)
GROUP BY dummy
LIMIT 1
SETTINGS distributed_group_by_no_merge = 2
FORMAT PrettyCompactMonoBlock

┌─dummy─┐
│     0 │
└───────┘

distributed_insert_skip_read_only_replicas

Permite ignorar réplicas em modo somente leitura em consultas INSERT para Distributed. Possible values:

0 — INSERT ocorrerá normalmente; se for direcionado a uma réplica em modo somente leitura, falhará
1 — O iniciador ignorará réplicas em modo somente leitura antes de enviar os dados aos shards.

distributed_product_mode

Altera o comportamento das subconsultas distribuídas. O ClickHouse aplica essa configuração quando a consulta contém o produto de tabelas distribuídas, ou seja, quando a consulta em uma tabela distribuída contém uma subconsulta não GLOBAL para a tabela distribuída. Restrições:

Aplicável apenas a subconsultas IN e JOIN.
Apenas se a seção FROM usar uma tabela distribuída com mais de um shard.
Se a subconsulta se referir a uma tabela distribuída com mais de um shard.
Não é usado para a função de tabela remote.

Valores possíveis:

deny — Valor padrão. Proíbe o uso desses tipos de subconsultas (retorna a exceção “Double-distributed in/JOIN subqueries is denied”).
local — Substitui o banco de dados e a tabela na subconsulta pelos locais do servidor de destino (shard), mantendo o IN/JOIN normal.
global — Substitui a consulta IN/JOIN por GLOBAL IN/GLOBAL JOIN.
allow — Permite o uso desses tipos de subconsultas.

distributed_push_down_limit

Habilita ou desabilita a aplicação de LIMIT separadamente em cada shard. Isso permite evitar:

O envio de linhas extras pela rede;
O processamento de linhas além do limite no nó iniciador.

A partir da versão 21.9, não é mais possível obter resultados imprecisos, já que distributed_push_down_limit altera a execução da consulta somente se pelo menos uma das condições abaixo for atendida:

distributed_group_by_no_merge > 0.
A consulta não tem GROUP BY/DISTINCT/LIMIT BY, mas tem ORDER BY/LIMIT.
A consulta tem GROUP BY/DISTINCT/LIMIT BY com ORDER BY/LIMIT e:
- optimize_skip_unused_shards está habilitado.
- optimize_distributed_group_by_sharding_key está habilitado.

Valores possíveis:

0 — Desativado.
1 — Habilitado.

Veja também:

​distributed_aggregation_memory_efficient

​distributed_connections_pool_size

​distributed_foreground_insert

​distributed_group_by_no_merge

​distributed_insert_skip_read_only_replicas

​distributed_product_mode

​distributed_push_down_limit