> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# shared_merge_* MergeTree テーブル設定

> shared_merge_* グループで生成される ClickHouse の MergeTree テーブル設定。

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["バージョン", "デフォルト値", "コメント"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        バージョン履歴
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>デフォルト値</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          再起動せずに変更可能
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

これらの設定は [system.merge\_tree\_settings](/ja/reference/system-tables/merge_tree_settings) で参照でき、ClickHouse のソースから自動生成されています。

<div id="shared_merge_tree_activate_coordinated_merges_tasks">
  ## shared\_merge\_tree\_activate\_coordinated\_merges\_tasks
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_create_per_replica_metadata_nodes">
  ## shared\_merge\_tree\_create\_per\_replica\_metadata\_nodes
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_disable_merges_and_mutations_assignment">
  ## shared\_merge\_tree\_disable\_merges\_and\_mutations\_assignment
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_empty_partition_lifetime">
  ## shared\_merge\_tree\_empty\_partition\_lifetime
</div>

<SettingsInfoBlock type="Seconds" default_value="86400" />

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

<div id="shared_merge_tree_enable_automatic_empty_partitions_cleanup">
  ## shared\_merge\_tree\_enable\_automatic\_empty\_partitions\_cleanup
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_enable_coordinated_merges">
  ## shared\_merge\_tree\_enable\_coordinated\_merges
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_enable_keeper_parts_extra_data">
  ## shared\_merge\_tree\_enable\_keeper\_parts\_extra\_data
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_enable_outdated_parts_check">
  ## shared\_merge\_tree\_enable\_outdated\_parts\_check
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_idle_parts_update_seconds">
  ## shared\_merge\_tree\_idle\_parts\_update\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="3600" />

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

<div id="shared_merge_tree_inactive_replica_cutoff_seconds">
  ## shared\_merge\_tree\_inactive\_replica\_cutoff\_seconds
</div>

<SettingsInfoBlock type="Seconds" default_value="0" />

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

<div id="shared_merge_tree_initial_parts_update_backoff_ms">
  ## shared\_merge\_tree\_initial\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="50" />

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

<div id="shared_merge_tree_interserver_http_connection_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_connection\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="100" />

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

<div id="shared_merge_tree_interserver_http_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="10000" />

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

<div id="shared_merge_tree_leader_update_period_random_add_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_random\_add\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

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

<div id="shared_merge_tree_leader_update_period_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="30" />

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

<div id="shared_merge_tree_max_outdated_parts_to_process_at_once">
  ## shared\_merge\_tree\_max\_outdated\_parts\_to\_process\_at\_once
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

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

<div id="shared_merge_tree_max_parts_update_backoff_ms">
  ## shared\_merge\_tree\_max\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="5000" />

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

<div id="shared_merge_tree_max_parts_update_leaders_in_total">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_in\_total
</div>

<SettingsInfoBlock type="UInt64" default_value="6" />

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

<div id="shared_merge_tree_max_parts_update_leaders_per_az">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_per\_az
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

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

<div id="shared_merge_tree_max_replicas_for_parts_deletion">
  ## shared\_merge\_tree\_max\_replicas\_for\_parts\_deletion
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

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

<div id="shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range">
  ## shared\_merge\_tree\_max\_replicas\_to\_merge\_parts\_for\_each\_parts\_range
</div>

<SettingsInfoBlock type="UInt64" default_value="5" />

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

<div id="shared_merge_tree_max_suspicious_broken_parts">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

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

<div id="shared_merge_tree_max_suspicious_broken_parts_bytes">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

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

<div id="shared_merge_tree_memo_ids_remove_timeout_seconds">
  ## shared\_merge\_tree\_memo\_ids\_remove\_timeout\_seconds
</div>

<SettingsInfoBlock type="Int64" default_value="1800" />

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

<div id="shared_merge_tree_merge_coordinator_distribution_algorithm">
  ## shared\_merge\_tree\_merge\_coordinator\_distribution\_algorithm
</div>

<SettingsInfoBlock type="MergeCoordinatorDistributionAlgorithm" default_value="water_filling" />

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

<div id="shared_merge_tree_merge_coordinator_election_check_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_election\_check\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="30000" />

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

<div id="shared_merge_tree_merge_coordinator_factor">
  ## shared\_merge\_tree\_merge\_coordinator\_factor
</div>

<SettingsInfoBlock type="Float" default_value="1.1" />

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

<div id="shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_fetch\_fresh\_metadata\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="10000" />

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

<div id="shared_merge_tree_merge_coordinator_max_merge_request_size">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_merge\_request\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="20" />

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

<div id="shared_merge_tree_merge_coordinator_max_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="10000" />

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

<div id="shared_merge_tree_merge_coordinator_merges_prepare_count">
  ## shared\_merge\_tree\_merge\_coordinator\_merges\_prepare\_count
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

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

<div id="shared_merge_tree_merge_coordinator_min_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_min\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="1" />

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

<div id="shared_merge_tree_merge_worker_fast_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_fast\_timeout\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="100" />

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

<div id="shared_merge_tree_merge_worker_regular_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_regular\_timeout\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="10000" />

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

<div id="shared_merge_tree_outdated_parts_group_size">
  ## shared\_merge\_tree\_outdated\_parts\_group\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

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

<div id="shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations">
  ## shared\_merge\_tree\_partitions\_hint\_ratio\_to\_reload\_merge\_pred\_for\_mutations
</div>

<SettingsInfoBlock type="Float" default_value="0.5" />

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

<div id="shared_merge_tree_parts_load_batch_size">
  ## shared\_merge\_tree\_parts\_load\_batch\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="32" />

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

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

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

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_rows\_threshold
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000" />

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

<div id="shared_merge_tree_range_for_merge_window_size">
  ## shared\_merge\_tree\_range\_for\_merge\_window\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

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

<div id="shared_merge_tree_read_virtual_parts_from_leader">
  ## shared\_merge\_tree\_read\_virtual\_parts\_from\_leader
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_replica_set_max_lifetime_seconds">
  ## shared\_merge\_tree\_replica\_set\_max\_lifetime\_seconds
</div>

<SettingsInfoBlock type="Seconds" default_value="1800" />

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

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas\_on\_startup
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_update_replica_flags_delay_ms">
  ## shared\_merge\_tree\_update\_replica\_flags\_delay\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="30000" />

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

<div id="shared_merge_tree_use_metadata_hints_cache">
  ## shared\_merge\_tree\_use\_metadata\_hints\_cache
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_use_outdated_parts_compact_format">
  ## shared\_merge\_tree\_use\_outdated\_parts\_compact\_format
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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

<div id="shared_merge_tree_use_too_many_parts_count_from_virtual_parts">
  ## shared\_merge\_tree\_use\_too\_many\_parts\_count\_from\_virtual\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_use_zookeeper_connection_pool">
  ## shared\_merge\_tree\_use\_zookeeper\_connection\_pool
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

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

<div id="shared_merge_tree_virtual_parts_discovery_batch">
  ## shared\_merge\_tree\_virtual\_parts\_discovery\_batch
</div>

<SettingsInfoBlock type="UInt64" default_value="1" />

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

<div id="shared_merge_tree_virtual_parts_partition_atomic_discovery">
  ## shared\_merge\_tree\_virtual\_parts\_partition\_atomic\_discovery
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

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