> ## 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.

# merge_max_* MergeTree 表设置

> ClickHouse MergeTree 表设置，属于自动生成的 merge_max_* 分组。

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/zh/reference/system-tables/merge_tree_settings)，并由 ClickHouse 源代码自动生成。

<div id="merge_max_block_size">
  ## merge\_max\_block\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="8192" />

从已合并的 分片 中读入内存的行数。

可能的值：

* 任意正整数。

合并 会按每块 `merge_max_block_size` 行从 分片 中读取数据行，
然后进行合并，并将结果写入一个新的 分片。读取的块会放入 RAM 中，
因此 `merge_max_block_size` 会影响合并所需的 RAM 大小。
所以，对于行非常宽的表，合并 可能会消耗大量 RAM
(如果平均每行大小为 100kb，那么在合并 10 个 分片 时，
(100kb \* 10 \* 8192) = 约 8GB RAM) 。减小 `merge_max_block_size`
可以减少一次 合并 所需的 RAM，但会降低 合并 速度。

<div id="merge_max_block_size_bytes">
  ## merge\_max\_block\_size\_bytes
</div>

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

合并操作中生成的块应包含多少字节的数据。默认情况下，
其值与 `index_granularity_bytes` 相同。

<div id="merge_max_bytes_to_prewarm_cache">
  ## merge\_max\_bytes\_to\_prewarm\_cache
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1073741824"},{"label": "Cloud sync"}]}]} />

仅在 ClickHouse Cloud 中可用。合并期间用于预热缓存的分片 (compact 或 packed) 的最大大小。

<div id="merge_max_dynamic_subcolumns_in_compact_part">
  ## merge\_max\_dynamic\_subcolumns\_in\_compact\_part
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "auto"},{"label": "新增一个设置，用于限制合并后 Compact 数据分片中的动态子列数量，而不受数据类型中指定参数的影响"}]}]} />

该设置用于限定合并后每个 Compact 数据分片中每一列可创建的动态子列最大数量。
无论数据类型中指定了哪些动态参数，它都可以控制 Compact 数据分片中的动态子列数量。

例如，如果表中某一列的类型为 JSON(max\_dynamic\_paths=1024)，并且将设置 merge\_max\_dynamic\_subcolumns\_in\_compact\_part 设为 128，
那么在合并到 Compact 数据分片后，该分片中的动态路径数量将减少到 128，并且只会有 128 个路径作为动态子列写入。

<div id="merge_max_dynamic_subcolumns_in_wide_part">
  ## merge\_max\_dynamic\_subcolumns\_in\_wide\_part
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "auto"},{"label": "新增一个设置，用于在合并后限制 Wide 分片 中动态子列的数量，而不受数据类型中指定参数的影响"}]}]} />

每一列在合并后于 Wide 数据分片中可创建的动态子列最大数量。
该设置可减少 Wide 数据分片中生成的文件数量，而不受数据类型中指定的动态参数影响。

例如，如果表中有一列的类型为 JSON(max\_dynamic\_paths=1024)，并且将设置 merge\_max\_dynamic\_subcolumns\_in\_wide\_part 设为 128，
那么在合并为 Wide 数据分片后，该数据分片中的动态路径数量将减少到 128，并且只有 128 条路径会作为动态子列写入。
