Skip to main content
Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.

parallel_replicas_allow_in_with_subquery

Si la valeur est true, la sous-requête de IN sera exécutée sur chaque réplique suiveuse.

parallel_replicas_allow_materialized_views

Autoriser l’utilisation des vues matérialisées avec les répliques parallèles

parallel_replicas_allow_view_over_mergetree

Permet aux répliques parallèles d’exécuter la requête externe d’une vue simple basée sur des tables MergeTree (au lieu de la requête interne de la vue), ce qui améliore la parallélisation entre les nœuds. S’applique également aux vues UNION ALL dont les branches lisent toutes dans des tables MergeTree différentes.

parallel_replicas_connect_timeout_ms

Délai d’expiration, en millisecondes, pour établir une connexion à une réplique distante lors de l’exécution d’une requête avec des répliques parallèles. Si le délai expire, la réplique correspondante n’est pas utilisée pour l’exécution de la requête

parallel_replicas_count

Il s’agit d’un paramètre interne qui ne doit pas être utilisé directement et qui correspond à un détail d’implémentation du mode « répliques parallèles ». Pour les requêtes distribuées, ce paramètre est automatiquement défini par le serveur initiateur sur le nombre de répliques parallèles participant au traitement de la requête.

parallel_replicas_custom_key

Une expression entière arbitraire qui peut être utilisée pour répartir le travail entre les répliques d’une table donnée. La valeur peut être n’importe quelle expression entière. Il est préférable d’utiliser des expressions simples basées sur les clés primaires. Si ce paramètre est utilisé sur un cluster composé d’un seul shard avec plusieurs répliques, ces répliques seront converties en shards virtuels. Sinon, il se comportera comme pour la clé SAMPLE et utilisera plusieurs répliques de chaque shard.

parallel_replicas_custom_key_range_lower

Permet au filtre de type range de répartir uniformément la charge entre les répliques à partir de la plage personnalisée [parallel_replicas_custom_key_range_lower, INT_MAX]. Utilisé conjointement avec parallel_replicas_custom_key_range_upper, il permet au filtre de répartir uniformément la charge entre les répliques sur la plage [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper]. Remarque : ce paramètre n’entraîne aucun filtrage de données supplémentaire pendant le traitement des requêtes ; il modifie simplement les points auxquels le filtre de plage découpe la plage [0, INT_MAX] pour le traitement parallèle.

parallel_replicas_custom_key_range_upper

Permet au filtre de type range de répartir uniformément le travail entre les répliques en fonction de la plage personnalisée [0, parallel_replicas_custom_key_range_upper]. Une valeur de 0 désactive la borne supérieure et la fixe à la valeur maximale de l’expression de clé personnalisée. Lorsqu’il est utilisé conjointement avec parallel_replicas_custom_key_range_lower, ce paramètre permet au filtre de répartir uniformément le travail entre les répliques sur la plage [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper]. Remarque : ce paramètre n’entraîne pas le filtrage de données supplémentaires pendant le traitement des requêtes ; il modifie plutôt les points auxquels le filtre de plage découpe la plage [0, INT_MAX] pour le traitement parallèle

parallel_replicas_filter_pushdown

Permet le pushdown des filtres sur la partie de la requête que les répliques parallèles choisissent d’exécuter

parallel_replicas_for_cluster_engines

Remplacer les moteurs de fonction de table par leurs équivalents -Cluster

parallel_replicas_for_non_replicated_merge_tree

Si la valeur est true, ClickHouse utilisera également l’algorithme des répliques parallèles pour les tables MergeTree non répliquées

parallel_replicas_index_analysis_only_on_coordinator

L’analyse d’index n’est effectuée que sur la réplique coordinatrice et est ignorée sur les autres répliques. Prend effet uniquement lorsque parallel_replicas_local_pla

parallel_replicas_insert_select_local_pipeline

Utiliser le pipeline local lors d’un INSERT SELECT distribué avec des répliques parallèles

parallel_replicas_local_plan

Construire un plan local pour la réplique locale

parallel_replicas_mark_segment_size

Les parts de données sont divisées virtuellement en segments, qui sont répartis entre les répliques pour la lecture parallèle. Ce paramètre contrôle la taille de ces segments. Il est déconseillé de le modifier à moins d’être absolument sûr de ce que vous faites. La valeur doit être comprise dans la plage [128 ; 16384]

parallel_replicas_min_number_of_rows_per_replica

Limite le nombre de répliques utilisées dans une requête à (nombre estimé de lignes à lire / min_number_of_rows_per_replica). Le maximum reste toutefois limité par ‘max_parallel_replicas’

parallel_replicas_mode

Type de filtre à utiliser avec la clé personnalisée pour les répliques parallèles. default - utilise l’opération modulo sur la clé personnalisée, range - utilise un filtre de plage sur la clé personnalisée en utilisant toutes les valeurs possibles du type de valeur de la clé personnalisée.

parallel_replicas_only_with_analyzer

L’analyseur doit être activé pour utiliser les répliques parallèles. Lorsque l’analyseur est désactivé, l’exécution de la requête retombe sur une exécution locale, même si la lecture parallèle depuis les répliques est activée. L’utilisation des répliques parallèles sans l’analyseur activé n’est pas prise en charge

parallel_replicas_plan_based

Exprime la frontière locale/distante des répliques parallèles sous forme de transformation du plan. Le planificateur construit un plan local simple ; une étape de séparation est ensuite insérée au-dessus de l’étape de lecture, puis remplacée par une UNION combinant une lecture locale et une lecture distante de la partie du plan située sous cette étape, de sorte que ce fragment s’exécute sur les répliques tandis que le reste s’exécute sur le coordinateur. Expérimental, prend le pas sur parallel_replicas_local_plan.

parallel_replicas_prefer_local_join

Si cette option est true, que JOIN peut être exécuté avec l’algorithme des répliques parallèles et que toutes les tables de la partie droite du JOIN sont de type *MergeTree, un JOIN local est utilisé à la place de GLOBAL JOIN.

parallel_replicas_prefer_local_replica

Lorsqu’il est activé (par défaut), la réplique locale est toujours incluse dans l’ensemble des répliques utilisées pour la lecture parallèle. Lorsqu’il est désactivé, la réplique locale ne bénéficie d’aucune préférence et les répliques sont sélectionnées uniquement par l’algorithme de répartition de charge. Cela permet d’acheminer les requêtes avec max_parallel_replicas = 1 vers un autre hôte, ce qui peut améliorer la localité du cache lorsque de nombreuses requêtes courtes sont réparties sur un cluster.

parallel_replicas_support_projection

L’optimisation des projections peut être appliquée aux répliques parallèles. S’applique uniquement lorsque parallel_replicas_local_plan est activé et que aggregation_in_order est inactif.
Dernière modification le 24 juillet 2026