Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

paramètres de table MergeTree shared_merge_*

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

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.90Nouveaux paramètres
25.80Nouveaux paramètres
25.70Nouveaux paramètres
25.60Nouveaux paramètres
25.100Nouveaux paramètres

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_blobs_list_inline_file_max_bytes

Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.90Nouveau paramètre qui stocke directement les petits fichiers d’une part blob-list dans le fichier blobs.list consolidé, plutôt que dans des blobs distincts

Stocke directement dans le fichier blobs.list consolidé les fichiers d’une part blob-list dont la taille ne dépasse pas ce nombre d’octets (par ex. count.txt, metadata_version.txt, les index minmax), plutôt que dans un blob de stockage d’objets distinct, économisant ainsi une écriture et une lecture de blob par petit fichier. 0 désactive l’intégration. Ne prend effet que pour les parts utilisant le stockage blob-list (voir shared_merge_tree_use_blobs_list_for_parts). Disponible uniquement dans ClickHouse Cloud.

shared_merge_tree_create_per_replica_metadata_nodes

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.110Réduit la quantité de métadonnées dans Keeper.
25.11Cloud sync

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

Type
Bool
Par défaut
0

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

shared_merge_tree_empty_partition_lifetime

Type
Secondes
Par défaut
86400
Historique des versions
VersionValeur par défautCommentaire
25.986400Nouveau paramètre

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

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
26.21Activé par défaut
25.90Nouveau paramètre

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

shared_merge_tree_enable_coordinated_merges

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
26.61Active les fusions coordonnées par défaut
25.50Nouveau paramètre

Active la stratégie des fusions coordonnées

shared_merge_tree_enable_keeper_parts_extra_data

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
26.61Les fusions coordonnées sont activées par défaut
25.30Nouveau paramètre

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

shared_merge_tree_enable_outdated_parts_check

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.11Cloud sync

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

shared_merge_tree_idle_parts_update_seconds

Type
UInt64
Par défaut
3600
Historique des versions
VersionValeur par défautCommentaire
25.13600Cloud sync

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

Type
Seconds
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.60Nouveau paramètre qui détermine pendant combien de temps une réplique inactive est prise en compte par le nettoyage en arrière-plan (0 signifie deux dépassements de délai de session ZooKeeper)

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

Type
UInt64
Par défaut
50
Historique des versions
VersionValeur par défautCommentaire
25.250Nouveau paramètre

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

shared_merge_tree_interserver_http_connection_timeout_ms

Type
UInt64
Par défaut
100
Historique des versions
VersionValeur par défautCommentaire
25.2100Nouveau paramètre

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

shared_merge_tree_interserver_http_timeout_ms

Type
UInt64
Par défaut
10000
Historique des versions
VersionValeur par défautCommentaire
25.110000Cloud sync

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

shared_merge_tree_leader_update_period_random_add_seconds

Type
UInt64
Par défaut
10
Historique des versions
VersionValeur par défautCommentaire
25.110Cloud sync

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

Type
UInt64
Par défaut
30
Historique des versions
VersionValeur par défautCommentaire
25.130Cloud sync

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

Type
UInt64
Par défaut
1000
Historique des versions
VersionValeur par défautCommentaire
25.11000Cloud sync

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

Type
UInt64
Par défaut
5000
Historique des versions
VersionValeur par défautCommentaire
25.25000Nouveau paramètre

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

Type
UInt64
Par défaut
6
Historique des versions
VersionValeur par défautCommentaire
25.16Cloud sync

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

shared_merge_tree_max_parts_update_leaders_per_az

Type
UInt64
Par défaut
2
Historique des versions
VersionValeur par défautCommentaire
25.12Cloud sync

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

shared_merge_tree_max_replicas_for_parts_deletion

Type
UInt64
Par défaut
10
Historique des versions
VersionValeur par défautCommentaire
25.110Cloud sync

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

Type
UInt64
Par défaut
5
Historique des versions
VersionValeur par défautCommentaire
25.15Cloud sync

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

Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.20Nombre maximal de parts défectueuses pour SMT ; au-delà, le détachement automatique est refusé

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

shared_merge_tree_max_suspicious_broken_parts_bytes

Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.20Taille maximale de l’ensemble des parties défectueuses pour SMT ; au-delà, le détachement automatique est refusé

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

Type
Int64
Par défaut
1800
Historique des versions
VersionValeur par défautCommentaire
25.11800Cloud sync

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

Type
MergeCoordinatorDistributionAlgorithm
Par défaut
sainte_lague
Historique des versions
VersionValeur par défautCommentaire
26.8sainte_lagueActive la distribution Sainte-Lague par défaut.
26.7water_fillingNouveau paramètre qui détermine l’algorithme utilisé par le coordinateur de fusion pour répartir les fusions entre les répliques

L’algorithme utilisé par le thread du coordinateur de fusion pour répartir les fusions entre les répliques.

Valeurs possibles :

  • water_filling
  • sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

Type
Millisecondes
Par défaut
30000
Historique des versions
VersionValeur par défautCommentaire
25.530000Nouveau paramètre

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

shared_merge_tree_merge_coordinator_factor

Type
Float
Par défaut
1.1
Historique des versions
VersionValeur par défautCommentaire
25.51.100000023841858Nouveau paramètre
25.101.100000023841858Temps d’attente réduit du coordinateur après la charge

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

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

Type
Millisecondes
Par défaut
10000
Historique des versions
VersionValeur par défautCommentaire
25.510000Nouveau paramètre

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

Type
UInt64
Par défaut
20
Historique des versions
VersionValeur par défautCommentaire
25.520Nouveau paramètre

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

shared_merge_tree_merge_coordinator_max_period_ms

Type
Millisecondes
Par défaut
10000
Historique des versions
VersionValeur par défautCommentaire
25.510000Nouveau paramètre

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

shared_merge_tree_merge_coordinator_merges_prepare_count

Type
UInt64Auto
Par défaut
auto
Historique des versions
VersionValeur par défautCommentaire
26.4autoDéfinir automatiquement le paramètre : nombre maximal de tâches de fusion par réplique * nombre de répliques actives
25.5100Nouveau paramètre

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

Type
Millisecondes
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.51Nouveau paramètre

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

shared_merge_tree_merge_worker_fast_timeout_ms

Type
Millisecondes
Par défaut
100
Historique des versions
VersionValeur par défautCommentaire
25.5100Nouveau paramètre

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

Type
Millisecondes
Par défaut
10000
Historique des versions
VersionValeur par défautCommentaire
25.510000Nouveau paramètre

Temps entre deux exécutions du thread de merge worker

shared_merge_tree_outdated_parts_group_size

Type
UInt64
Par défaut
2
Historique des versions
VersionValeur par défautCommentaire
25.92Nouveau paramètre

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

Type
Float
Par défaut
0.5

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

Type
UInt64
Par défaut
32

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

Type
UInt64
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.10Cloud sync

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

Type
UInt64
Par défaut
1000000
Historique des versions
VersionValeur par défautCommentaire
25.11000000Cloud sync

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

Type
UInt64
Par défaut
10
Historique des versions
VersionValeur par défautCommentaire
25.110Cloud sync

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

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.11Cloud sync

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

shared_merge_tree_replica_set_max_lifetime_seconds

Type
Secondes
Par défaut
1800
Historique des versions
VersionValeur par défautCommentaire
26.41800Augmenter l’intervalle par défaut de mise à jour en arrière-plan de l’ensemble de répliques à 30 minutes
26.2300Nouveau paramètre

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

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.10Nouveau paramètre pour récupérer les données des parts depuis d'autres répliques

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

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.60Nouveau paramètre permettant à SMT de récupérer au démarrage les données des parts depuis les répliques plutôt que depuis S3

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

Type
Millisecondes
Par défaut
30000
Historique des versions
VersionValeur par défautCommentaire
25.830000Nouveau paramètre

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

shared_merge_tree_use_blobs_list_for_parts

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.90Nouveau paramètre qui stocke la map des blobs par fichier d'une part SharedMergeTree dans un unique nœud Keeper consolidé au lieu d'un nœud par fichier

Stocke les parts d'une table SharedMergeTree (Wide et Compact) dans un unique nœud de métadonnées blob-list consolidé au lieu d'un nœud Keeper par fichier. Réduit les métadonnées Keeper par part de O(fichiers) à une petite constante tout en conservant un blob de stockage d'objets par fichier. Disponible uniquement dans ClickHouse Cloud.

shared_merge_tree_use_metadata_hints_cache

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.11Cloud sync

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

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.91Activer les parts obsolètes v3 par défaut
25.10Cloud sync

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

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
25.10Cloud sync

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

Type
Bool
Par défaut
0
Historique des versions
VersionValeur par défautCommentaire
26.30Nouveau paramètre

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

Type
UInt64
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
25.81Nouveau paramètre

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

shared_merge_tree_virtual_parts_partition_atomic_discovery

Type
Bool
Par défaut
1
Historique des versions
VersionValeur par défautCommentaire
26.71Nouveau paramètre

Paramètre obsolète, sans effet.

Navigation