Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão parallel_replicas_*

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

parallel_replicas_allow_in_with_subquery

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.31Se true, a subconsulta de IN será executada em cada réplica seguidora

Se true, a subconsulta de IN será executada em cada réplica seguidora.

parallel_replicas_allow_materialized_views

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.121Permitir o uso de visões materializadas com réplicas paralelas

Permitir o uso de visões materializadas com réplicas paralelas

parallel_replicas_allow_view_over_mergetree

Recurso beta
Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.40Nova configuração

Permite que réplicas paralelas executem a consulta externa de uma view simples sobre tabelas MergeTree (em vez da consulta interna da view), melhorando a paralelização entre os nós. Também se aplica a views UNION ALL cujas ramificações leem de tabelas MergeTree diferentes.

parallel_replicas_connect_timeout_ms

Tipo
Milissegundos
Padrão
300
Histórico de versões
VersãoValor padrãoComentário
25.6300Timeout de conexão separado para consultas com réplicas paralelas

O timeout, em milissegundos, para se conectar a uma réplica remota durante a execução da consulta com réplicas paralelas. Se o timeout expirar, a réplica correspondente não será usada para a execução da consulta

parallel_replicas_count

Recurso beta
Tipo
UInt64
Padrão
0

Esta é uma configuração interna que não deve ser usada diretamente e representa um detalhe de implementação do modo de 'réplicas paralelas'. Essa configuração será definida automaticamente pelo servidor iniciador, em consultas distribuídas, com o número de réplicas paralelas que participam do processamento da consulta.

parallel_replicas_custom_key

Recurso beta

Uma expressão inteira arbitrária que pode ser usada para dividir o trabalho entre réplicas de uma tabela específica. O valor pode ser qualquer expressão inteira.

Prefira expressões simples que usem chaves primárias.

Se a configuração for usada em um cluster composto por um único shard com várias réplicas, essas réplicas serão convertidas em shards virtuais. Caso contrário, ela se comportará da mesma forma que a chave SAMPLE, usando várias réplicas de cada shard.

parallel_replicas_custom_key_range_lower

Recurso beta
Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.60Adiciona configurações para controlar o filtro de intervalo ao usar réplicas paralelas com shards dinâmicos

Permite que o tipo de filtro range divida o trabalho de forma equilibrada entre réplicas com base no intervalo personalizado [parallel_replicas_custom_key_range_lower, INT_MAX].

Quando usado em conjunto com parallel_replicas_custom_key_range_upper, ele permite que o filtro divida de forma equilibrada o trabalho entre as réplicas no intervalo [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Nota: essa configuração não fará com que dados adicionais sejam filtrados durante o processamento de consultas; em vez disso, ela altera os pontos em que o filtro de intervalo divide o intervalo [0, INT_MAX] para processamento paralelo.

parallel_replicas_custom_key_range_upper

Recurso beta
Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.60Adiciona configurações para controlar o filtro de intervalo ao usar réplicas paralelas com shards dinâmicos. Um valor de 0 desativa o limite superior

Permite que o tipo de filtro range divida o trabalho de maneira uniforme entre as réplicas com base no intervalo personalizado [0, parallel_replicas_custom_key_range_upper]. Um valor de 0 desativa o limite superior, definindo-o como o valor máximo da expressão de chave personalizada.

Quando usado em conjunto com parallel_replicas_custom_key_range_lower, ele permite que o filtro divida uniformemente o trabalho entre as réplicas no intervalo [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Observação: essa configuração não fará com que dados adicionais sejam filtrados durante o processamento da consulta; em vez disso, ela altera os pontos em que o filtro de intervalo divide o intervalo [0, INT_MAX] para processamento paralelo

parallel_replicas_filter_pushdown

Recurso beta
Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.20Nova configuração

Permite fazer o pushdown de filtros para a parte da consulta que as réplicas paralelas escolhem executar

parallel_replicas_for_cluster_engines

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.31Nova configuração.

Substitua os motores de funções de tabela por suas alternativas -Cluster

parallel_replicas_for_non_replicated_merge_tree

Tipo
Bool
Padrão
0

Se true, o ClickHouse também usará o algoritmo de réplicas paralelas para tabelas MergeTree não replicadas

parallel_replicas_index_analysis_only_on_coordinator

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.121A análise de índice é feita apenas na réplica coordenadora e ignorada nas demais réplicas. Só tem efeito com parallel_replicas_local_plan habilitado
24.101A análise de índice é feita apenas na réplica coordenadora e ignorada nas demais réplicas. Só tem efeito com parallel_replicas_local_plan habilitado

A análise de índice é feita apenas na réplica coordenadora e ignorada nas demais réplicas. Só tem efeito com parallel_replicas_local_pla habilitado

parallel_replicas_insert_select_local_pipeline

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.51Usa pipeline local durante INSERT SELECT distribuído com réplicas paralelas. Atualmente desativado devido a problemas de desempenho
25.40Usa pipeline local durante INSERT SELECT distribuído com réplicas paralelas. Atualmente desativado devido a problemas de desempenho

Usa pipeline local durante INSERT SELECT distribuído com réplicas paralelas

parallel_replicas_local_plan

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.90Usar plano local para a réplica local em uma consulta com réplicas paralelas
24.111Usar plano local para a réplica local em uma consulta com réplicas paralelas
24.101Usar plano local para a réplica local em uma consulta com réplicas paralelas

Constrói o plano local para a réplica local

parallel_replicas_mark_segment_size

Tipo
UInt64
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
24.90O valor desta configuração agora é determinado automaticamente
24.1128Nova configuração adicionada para controlar o tamanho do segmento na nova implementação do coordenador de réplicas paralelas

Partes divididas virtualmente em segmentos para serem distribuídos entre réplicas para leitura paralela. Essa configuração controla o tamanho desses segmentos. Não é recomendável alterá-la até que você tenha absoluta certeza do que está fazendo. O valor deve estar no intervalo [128; 16384]

parallel_replicas_min_number_of_rows_per_replica

Tipo
UInt64
Padrão
0

Limita o número de réplicas usadas em uma consulta a (linhas estimadas para leitura / min_number_of_rows_per_replica). O valor máximo continua sendo limitado por 'max_parallel_replicas'

parallel_replicas_mode

Tipo
ParallelReplicasMode
Padrão
read_tasks
Histórico de versões
VersãoValor padrãoComentário
24.10read_tasksEsta configuração foi introduzida como parte da disponibilização do recurso de réplicas paralelas em Beta

Tipo de filtro a ser usado com chave personalizada para réplicas paralelas. default - usa a operação de módulo na chave personalizada, range - usa um filtro de intervalo na chave personalizada, usando todos os valores possíveis para o tipo de valor da chave personalizada.

parallel_replicas_only_with_analyzer

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.21Réplicas paralelas têm suporte apenas com o analisador habilitado

O analisador deve estar habilitado para usar réplicas paralelas. Com o analisador desabilitado, a execução da consulta volta para a execução local, mesmo que a leitura paralela a partir de réplicas esteja habilitada. O uso de réplicas paralelas sem o analisador habilitado não tem suporte

parallel_replicas_plan_based

Recurso experimental
Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.70Nova configuração

Decide se e onde usar réplicas paralelas analisando o plano da consulta, em vez de usar a análise baseada na árvore de consulta. Como resultado, um fragmento do plano é enviado às réplicas remotas em vez de uma consulta SQL. Experimental.

parallel_replicas_prefer_local_join

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
24.21Se true, e o JOIN puder ser executado com o algoritmo de réplicas paralelas, e todos os armazenamentos no lado direito do JOIN forem *MergeTree, será usado JOIN local em vez de GLOBAL JOIN.

Se true, e o JOIN puder ser executado com o algoritmo de réplicas paralelas, e todos os armazenamentos no lado direito do JOIN forem *MergeTree, será usado JOIN local em vez de GLOBAL JOIN.

parallel_replicas_prefer_local_replica

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
26.51Nova configuração. Quando desativada, as réplicas para leitura paralela são selecionadas exclusivamente pelo algoritmo de balanceamento de carga, sem forçar a inclusão da réplica local no conjunto.

Quando ativada (padrão), a réplica local é sempre incluída no conjunto de réplicas usado para leitura paralela. Quando desativada, a réplica local não recebe nenhuma preferência, e as réplicas são selecionadas exclusivamente pelo algoritmo de balanceamento de carga. Isso permite que consultas com max_parallel_replicas = 1 sejam direcionadas para outro host, o que pode melhorar a localidade de cache quando muitas consultas curtas são distribuídas em um cluster.

parallel_replicas_support_projection

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
25.81Nova configuração. A otimização de projeções pode ser aplicada em réplicas paralelas. Só tem efeito quando parallel_replicas_local_plan está habilitado e aggregation_in_order está inativo.

A otimização de projeções pode ser aplicada em réplicas paralelas. Só tem efeito quando parallel_replicas_local_plan está habilitado e aggregation_in_order está inativo.

Navigation