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_merge_tables

Permite a leitura de uma tabela Merge com réplicas paralelas. Só tem efeito em conjunto com parallel_replicas_plan_based: a leitura da tabela Merge é expandida em uma union das leituras das tabelas MergeTree subjacentes, que então é distribuída como qualquer outra union. Uma tabela Merge fica restrita a uma única réplica quando alguma de suas tabelas subjacentes não pode ser lida dessa forma (uma tabela que não seja MergeTree, uma leitura FINAL). Defina como false para ler cada tabela Merge em uma única réplica, como ocorria antes da adição desse suporte. Experimental.

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. A expressão é verificada em relação aos grants de SELECT em nível de coluna do usuário. Para uma VIEW com SQL SECURITY DEFINER ou NONE, ela é aplicada às colunas da VIEW; o body da VIEW é lido sem essa verificação.

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

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

Se true, e o JOIN puder ser executado com o algoritmo de réplicas paralelas, e cada armazenamento do lado do JOIN que de outra forma seria materializado em uma temporary table puder ser lido por cada réplica de forma independente, será usado JOIN local em vez de GLOBAL JOIN. Esse lado é o direito, exceto em um RIGHT JOIN, em que é o esquerdo e em que cada armazenamento precisa ser elegível para réplicas paralelas, e não apenas ser *MergeTree. Um armazenamento sob o lado materializado de um GLOBAL JOIN aninhado, ou sob um GLOBAL IN, não conta, pois o initiator materializa esses casos por conta própria.

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 26 de setembro de 2026