Skip to main content
これらの設定は system.merge_tree_settings で参照でき、ClickHouse のソースから自動生成されています。

shared_merge_tree_activate_coordinated_merges_tasks

協調マージタスクの再スケジューリングを有効にします。これは、 shared_merge_tree_enable_coordinated_merges=0 の場合でも、マージコーディネーターの 統計情報が蓄積され、コールドスタートに役立つため有用です。

shared_merge_tree_create_per_replica_metadata_nodes

ZooKeeper で、レプリカごとの /metadata ノードと /columns ノードを作成できるようにします。 ClickHouse Cloud でのみ利用できます

shared_merge_tree_disable_merges_and_mutations_assignment

shared merge tree のマージ割り当てを停止します。ClickHouse Cloud でのみ使用できます

shared_merge_tree_empty_partition_lifetime

パーツがないパーティションをKeeperに保持する秒数。

shared_merge_tree_enable_automatic_empty_partitions_cleanup

空のパーティションに対応する Keeper エントリのクリーンアップを有効にします。

shared_merge_tree_enable_coordinated_merges

協調マージ 戦略を有効化します

shared_merge_tree_enable_keeper_parts_extra_data

仮想パーツへの属性の書き込みと、Keeper でのブロックのコミットを有効にします

shared_merge_tree_enable_outdated_parts_check

古くなったパーツのチェックを有効にします。ClickHouse Cloud でのみ利用できます

shared_merge_tree_idle_parts_update_seconds

shared merge tree で、ZooKeeper の watch によるトリガーなしでパーツを更新する間隔 (秒) です。ClickHouse Cloud でのみ利用できます

shared_merge_tree_inactive_replica_cutoff_seconds

非アクティブなレプリカがバックグラウンドクリーンアップ (OutdatedPartsQuorumThread) で引き続き考慮される期間を指定します。レプリカの非アクティブ時間がこの秒数未満である間は、 そのレプリカによって古くなったパーツの削除と完了したミューテーションの切り捨てが保留されます。値が 0 の場合は、 デフォルトの ZooKeeper のセッションタイムアウト 2 回分が使用されます。 ClickHouse Cloud でのみ使用できます

shared_merge_tree_initial_parts_update_backoff_ms

パーツ更新時の初期バックオフ。ClickHouse Cloud でのみ利用可能

shared_merge_tree_interserver_http_connection_timeout_ms

サーバー間のHTTP接続のタイムアウト。ClickHouse Cloud でのみ利用できます

shared_merge_tree_interserver_http_timeout_ms

サーバー間 HTTP 通信のタイムアウトです。ClickHouse Cloud でのみ利用できます

shared_merge_tree_leader_update_period_random_add_seconds

サンダリングハード現象を回避するため、 0〜x秒の範囲で一様分布する値を shared_merge_tree_leader_update_period に加算します。ClickHouse Cloud でのみ利用できます

shared_merge_tree_leader_update_period_seconds

パーツ更新におけるリーダーシップを再確認する最大周期。利用できるのは ClickHouse Cloud のみです。

shared_merge_tree_max_outdated_parts_to_process_at_once

リーダーが1回のHTTPリクエストで削除対象として確認を試みる、古くなったパーツの最大数です。ClickHouse Cloudでのみ利用できます。

shared_merge_tree_max_parts_update_backoff_ms

パーツ更新の最大バックオフ時間。ClickHouse Cloud でのみ利用可能

shared_merge_tree_max_parts_update_leaders_in_total

パーツ更新リーダーの最大数。ClickHouse Cloudでのみ利用できます

shared_merge_tree_max_parts_update_leaders_per_az

パーツ更新リーダーの最大数。ClickHouse Cloud でのみ利用可能

shared_merge_tree_max_replicas_for_parts_deletion

パーツ削除 (キラースレッド) に参加するレプリカの最大数です。ClickHouse Cloud でのみ利用できます

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

競合する可能性のあるマージの割り当てを試行するレプリカの最大数です (これにより、マージ割り当て時の不要な競合を回避できます) 。0 は無効を意味します。ClickHouse Cloud でのみ使用できます

shared_merge_tree_max_suspicious_broken_parts

SMT の破損したパーツの最大数。これを超えると、自動デタッチは行われません。

shared_merge_tree_max_suspicious_broken_parts_bytes

SMT におけるすべての破損パーツの合計サイズの上限。この値を超えると、自動デタッチは許可されません。

shared_merge_tree_memo_ids_remove_timeout_seconds

insert の再試行中に誤った操作を防ぐため、insert のメモ化 ID を保持する期間です。 ClickHouse Cloud でのみ利用できます

shared_merge_tree_merge_coordinator_distribution_algorithm

マージコーディネータースレッドが、レプリカ間でマージを分散する際に使用するアルゴリズム

shared_merge_tree_merge_coordinator_election_check_period_ms

マージコーディネーター選出スレッドの実行間隔

shared_merge_tree_merge_coordinator_factor

コーディネータースレッドの遅延時間を変更する係数

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

マージコーディネーターが最新のメタデータを取得するためにZooKeeperと同期する頻度

shared_merge_tree_merge_coordinator_max_merge_request_size

マージコーディネーターが一度に MergerMutator にリクエストできるマージ数

shared_merge_tree_merge_coordinator_max_period_ms

マージコーディネータースレッドの実行間の最大間隔

shared_merge_tree_merge_coordinator_merges_prepare_count

マージコーディネーターが準備し、各ワーカーに分配するマージエントリの数。 ‘auto’ に設定すると、1 つのレプリカで許可される最大マージタスク数に、アクティブなレプリカ数を掛けた値になります。

shared_merge_tree_merge_coordinator_min_period_ms

マージコーディネータースレッドの実行間の最小時間

shared_merge_tree_merge_worker_fast_timeout_ms

即時アクション後に状態を更新する必要がある場合に、マージワーカースレッドが使用するタイムアウト

shared_merge_tree_merge_worker_regular_timeout_ms

マージワーカースレッドの実行間隔

shared_merge_tree_outdated_parts_group_size

古くなったパーツ のクリーンアップ時に、同じランデブーハッシュグループに属するレプリカ数。 ClickHouse Cloud でのみ利用できます。

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

<candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> の比率がこの設定値を上回ると、merge/mutate の選択タスクで merge predicate を再読み込みします。ClickHouse Cloud でのみ利用できます

shared_merge_tree_parts_load_batch_size

一度にスケジュールする、フェッチするパーツのメタデータジョブ数。利用できるのは ClickHouse Cloud のみです。

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

ローカルでマージされたパーツを含む新たなマージを開始せずに、そのパーツを保持しておく時間です。 これにより、他のレプリカがそのパーツをフェッチし、このマージを開始する機会を確保できます。 ClickHouse Cloud でのみ利用できます。

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

ローカルでマージした直後に次のマージの割り当てを延期するための、パーツの最小サイズ (行数) です。ClickHouse Cloud でのみ利用できます。

shared_merge_tree_range_for_merge_window_size

レプリカ間でマージ割り当てを分散する際に使用するウィンドウサイズ (block番号単位) 。 同じウィンドウ内のパーツは同じレプリカに割り当てられます。 ClickHouse Cloud でのみ利用できます

shared_merge_tree_read_virtual_parts_from_leader

可能な場合はリーダーから仮想パーツを読み取ります。ClickHouse Cloudでのみ利用できます。

shared_merge_tree_replica_set_max_lifetime_seconds

レプリカがバックグラウンドでレプリカセットの更新を試みる頻度です。次回の実行は [0, value] 秒の範囲で 一様にランダム化されます。例外: value = 0 はこのルールに従いません。 実装では最小 200 ms が適用されるため、次回の実行は [0, 200] ms の範囲でランダム化されます。

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

有効にすると、すべてのレプリカは、すでにそのデータを保持している他のレプリカから、パーツのメモリ内データ (プライマリキー、パーティション情報など) を取得しようとします。

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

有効にすると、すべてのレプリカは起動時に、すでにそのデータを保持している他のレプリカから、パーツのメモリ内データ (主キー、パーティション情報など) を取得しようとします。

shared_merge_tree_update_replica_flags_delay_ms

レプリカがバックグラウンドスケジュールに従ってフラグの再読み込みを試行する間隔。

shared_merge_tree_use_metadata_hints_cache

他のレプリカ上のインメモリ cacheからFS cacheヒントをリクエストできるようにします。ClickHouse Cloudでのみ利用できます

shared_merge_tree_use_outdated_parts_compact_format

outdated パーツには compact フォーマットを使用します。これにより Keeper への負荷が軽減され、 outdated パーツの処理が改善されます。ClickHouse Cloud でのみ利用可能です

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

有効にすると、パーツが多すぎるカウンターはローカルレプリカの状態ではなく、Keeper 内の shared data を参照します。ClickHouse Cloud でのみ利用できます

shared_merge_tree_use_zookeeper_connection_pool

有効にすると、SharedMergeTree はサーバーレベルのプールされた ZooKeeper セッションのいずれかを使用します。

shared_merge_tree_virtual_parts_discovery_batch

1つのバッチにまとめるパーティション検出の数

shared_merge_tree_virtual_parts_partition_atomic_discovery

SMT が、追加のデータ取得とウォッチ設定を伴って、仮想パーツのパーティションをアトミックに検出するかどうか。
最終更新日 2026年7月23日