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

shared_merge_tree_activate_coordinated_merges_tasks

Active la replanification des tâches de fusions coordonnées. Cela peut être utile même lorsque shared_merge_tree_enable_coordinated_merges=0, car cela alimentera les statistiques du coordinateur de fusion et facilitera le démarrage à froid.

shared_merge_tree_create_per_replica_metadata_nodes

Active la création des nœuds /metadata et /columns pour chaque réplique dans ZooKeeper. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_disable_merges_and_mutations_assignment

Interrompt l’attribution des merges pour shared merge tree. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_empty_partition_lifetime

Nombre de secondes pendant lesquelles une partition est conservée dans Keeper si elle ne comporte aucune part.

shared_merge_tree_enable_automatic_empty_partitions_cleanup

Active le nettoyage des entrées Keeper associées aux partitions vides.

shared_merge_tree_enable_coordinated_merges

Active la stratégie des fusions coordonnées

shared_merge_tree_enable_keeper_parts_extra_data

Permet d’écrire des attributs dans les parties virtuelles et de valider les blocs dans Keeper

shared_merge_tree_enable_outdated_parts_check

Active la vérification des parts obsolètes. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_idle_parts_update_seconds

Intervalle, en secondes, entre les mises à jour des parts lorsqu’elles ne sont pas déclenchées par un watch ZooKeeper dans le shared merge tree. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_inactive_replica_cutoff_seconds

Durée pendant laquelle une réplique inactive est encore prise en compte par le nettoyage en arrière-plan (OutdatedPartsQuorumThread) : tant qu’une réplique est inactive depuis moins que ce nombre de secondes, elle retarde la suppression des parts obsolètes et la troncature des mutations terminées. Une valeur de 0 signifie que la valeur par défaut de deux dépassements de délai de session ZooKeeper est utilisée. Uniquement dans ClickHouse Cloud

shared_merge_tree_initial_parts_update_backoff_ms

Backoff initial pour la mise à jour des parts. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_interserver_http_connection_timeout_ms

Dépassements de délai de la connexion HTTP interserveur. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_interserver_http_timeout_ms

Délai d’expiration pour la communication HTTP interserveur. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_leader_update_period_random_add_seconds

Ajoute une valeur uniformément répartie de 0 à x secondes à shared_merge_tree_leader_update_period afin d’éviter l’effet de troupeau. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_leader_update_period_seconds

Période maximale avant de revérifier le rôle de leader pour la mise à jour des parts. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_max_outdated_parts_to_process_at_once

Nombre maximal de parts obsolètes que le leader tentera de confirmer pour suppression en une requête HTTP. Disponible uniquement dans ClickHouse Cloud.

shared_merge_tree_max_parts_update_backoff_ms

Délai de backoff maximal pour la mise à jour des parts. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_in_total

Nombre maximal de leaders de mise à jour des parts. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_max_parts_update_leaders_per_az

Nombre maximal de leaders de mise à jour des parts. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_max_replicas_for_parts_deletion

Nombre maximal de répliques participant à la suppression des parts (thread killer). Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

Nombre maximal de répliques qui tenteront d’attribuer des fusions susceptibles d’entrer en conflit (permet d’éviter des conflits redondants dans l’attribution des fusions). 0 signifie désactivé. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_max_suspicious_broken_parts

Nombre maximal de parts défectueuses pour SMT ; au-delà, le détachement automatique est refusé.

shared_merge_tree_max_suspicious_broken_parts_bytes

Taille maximale de l’ensemble des parties défectueuses pour SMT ; au-delà, le détachement automatique est refusé.

shared_merge_tree_memo_ids_remove_timeout_seconds

Durée de conservation des identifiants de mémoïsation d’insert pour éviter des actions incorrectes lors des tentatives répétées d’insert. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_merge_coordinator_distribution_algorithm

Algorithme utilisé par le thread du coordinateur de fusion pour répartir les fusions entre les répliques

shared_merge_tree_merge_coordinator_election_check_period_ms

Intervalle entre deux exécutions du thread d’élection du coordinateur de fusion

shared_merge_tree_merge_coordinator_factor

Facteur de variation dans le temps du délai du thread du coordinateur

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

Fréquence à laquelle le coordinateur de fusion doit se synchroniser avec ZooKeeper pour récupérer des métadonnées à jour

shared_merge_tree_merge_coordinator_max_merge_request_size

Nombre de fusions que le coordinateur peut demander simultanément à MergerMutator

shared_merge_tree_merge_coordinator_max_period_ms

Intervalle maximal entre deux exécutions du thread du coordinateur de fusion

shared_merge_tree_merge_coordinator_merges_prepare_count

Nombre d’entrées de fusion que le coordinateur doit préparer et répartir entre les workers. Lorsqu’il est défini sur ‘auto’, il est égal au nombre maximal de tâches de fusion autorisées sur une seule réplique, multiplié par le nombre de répliques actives.

shared_merge_tree_merge_coordinator_min_period_ms

Délai minimal entre deux exécutions du thread du coordinateur de fusion

shared_merge_tree_merge_worker_fast_timeout_ms

Délai d’expiration utilisé par le thread du merge worker s’il doit mettre à jour son état après une action immédiate

shared_merge_tree_merge_worker_regular_timeout_ms

Temps entre deux exécutions du thread de merge worker

shared_merge_tree_outdated_parts_group_size

Nombre de répliques qui se trouveront dans le même groupe de hachage de rendez-vous pour le nettoyage des parts obsolètes. Disponible uniquement dans ClickHouse Cloud.

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

Recharge le prédicat de fusion dans la tâche de sélection de fusion/mutation lorsque le ratio <candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> est supérieur à ce paramètre. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_parts_load_batch_size

Nombre de jobs de récupération des métadonnées des parts à planifier simultanément. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

Durée pendant laquelle une part fusionnée localement est conservée sans lancer une nouvelle fusion l’incluant. Cela laisse aux autres répliques le temps de récupérer la part et de lancer cette fusion. Disponible uniquement dans ClickHouse Cloud.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

Taille minimale d’une part (en lignes) à partir de laquelle l’attribution de la fusion suivante est reportée juste après une fusion locale. Disponible uniquement dans ClickHouse Cloud.

shared_merge_tree_range_for_merge_window_size

Taille de la fenêtre (en numéros de blocs) utilisée pour répartir l’attribution des fusions entre les répliques. Les parts dans la même fenêtre sont attribuées aux mêmes répliques. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_read_virtual_parts_from_leader

Lit les parties virtuelles depuis le leader lorsque cela est possible. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_replica_set_max_lifetime_seconds

Fréquence à laquelle les répliques tenteront de mettre à jour l’ensemble de répliques en arrière-plan. La prochaine exécution est décalée uniformément dans l’intervalle [0, value] secondes. Exception : value = 0 ne suit pas cette règle ; l’implémentation applique un minimum de 200 ms, de sorte que la prochaine exécution est décalée dans l’intervalle [0, 200] ms.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

Si ce paramètre est activé, toutes les répliques tentent de récupérer depuis d’autres répliques, lorsqu’elles y existent déjà, les données en mémoire d’une partie (comme la clé primaire, les informations de partition, etc.).

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

Si ce paramètre est activé, toutes les répliques tentent, au démarrage, de récupérer auprès d’autres répliques les données en mémoire des parts (comme la clé primaire, les informations de partition, etc.) lorsqu’elles y existent déjà.

shared_merge_tree_update_replica_flags_delay_ms

Fréquence à laquelle la réplique tentera de recharger ses flags selon la planification en arrière-plan.

shared_merge_tree_use_metadata_hints_cache

Permet de demander des indications de cache FS à partir du cache en mémoire d’autres répliques. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_use_outdated_parts_compact_format

Utilise le format compact pour les parts obsolètes : réduit la charge sur Keeper, améliore le traitement des parts obsolètes. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

Si ce paramètre est activé, le compteur Too many parts s’appuie sur les données partagées dans Keeper, et non sur l’état local de la réplique. Disponible uniquement dans ClickHouse Cloud

shared_merge_tree_use_zookeeper_connection_pool

Si ce paramètre est activé, SharedMergeTree utilise l’une des sessions ZooKeeper du pool au niveau du serveur.

shared_merge_tree_virtual_parts_discovery_batch

Nombre de découvertes de partitions à regrouper dans un lot

shared_merge_tree_virtual_parts_partition_atomic_discovery

SMT découvrira de façon atomique la partition des parties virtuelles, avec une récupération de données supplémentaire et la mise en place de watches.
Dernière modification le 23 juillet 2026