> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# max_bytes_* MergeTree テーブル設定

> max_bytes_* グループに含まれる ClickHouse の MergeTree テーブル設定。

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](/docs/ja/reference/system-tables/merge_tree_settings) で確認でき、ClickHouse のソースコードから自動生成されています。

<div id="max_bytes_to_merge_at_max_space_in_pool">
  ## max\_bytes\_to\_merge\_at\_max\_space\_in\_pool
</div>

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

利用可能なリソースが十分にある場合に、複数のパーツを 1 つのパーツにマージする際の、合計サイズ (バイト単位) の上限です。これは、自動バックグラウンドマージによって作成されるパーツの最大サイズにおおよそ相当します。 (0 はマージが無効になることを意味します)

設定可能な値:

* 0 以上の任意の整数。

マージスケジューラは定期的にパーティション内のパーツのサイズと数を分析し、プールに十分な空きリソースがあれば、バックグラウンドマージを開始します。マージは、ソースパーツの合計サイズが `max_bytes_to_merge_at_max_space_in_pool` より大きくなるまで実行されます。

[OPTIMIZE FINAL](/docs/ja/reference/statements/optimize) によって開始されたマージでは、`max_bytes_to_merge_at_max_space_in_pool` は無視されます (考慮されるのは空きディスク容量のみです) 。

<div id="max_bytes_to_merge_at_min_space_in_pool">
  ## max\_bytes\_to\_merge\_at\_min\_space\_in\_pool
</div>

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

バックグラウンドプールで利用可能なリソースが最小限のときに、
複数のパーツを1つのパーツへマージする際の合計パーツサイズ (バイト単位) の最大値です。

設定可能な値:

* 任意の正の整数。

`max_bytes_to_merge_at_min_space_in_pool` は、
利用可能なディスク領域 (プール内) が不足している場合でもマージできる
パーツの合計サイズの上限を定義します。
これは、小さなパーツの数を減らし、
`パーツが多すぎる` エラーが発生する可能性を下げるために必要です。
マージでは、マージ対象パーツの合計サイズの2倍のディスク領域が予約されます。
そのため、ディスクの空き領域が少ない場合、
空き領域自体はあっても、その領域が進行中の大規模なマージですでに予約されているため、
ほかのマージを開始できず、insert のたびに小さなパーツが増えていく状況が発生することがあります。