Skip to main content
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

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

parallel_replicas_allow_materialized_views

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

parallel_replicas_allow_view_over_mergetree

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

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

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

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

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

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

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

parallel_replicas_for_cluster_engines

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

parallel_replicas_for_non_replicated_merge_tree

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

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

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

parallel_replicas_local_plan

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

parallel_replicas_mark_segment_size

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

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 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

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

Expressa a fronteira local/remota das réplicas paralelas por meio de uma transformação do plano. O planner cria um plano local simples; em seguida, uma etapa de divisão é inserida acima da etapa de leitura e substituída por uma UNION entre uma leitura local e uma leitura remota da parte do plano abaixo da etapa de divisão, para que esse fragmento seja executado nas réplicas enquanto o restante é executado no coordenador. Experimental; tem precedência sobre parallel_replicas_local_plan.

parallel_replicas_prefer_local_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

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

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.
Última modificação em 24 de julho de 2026