> ## 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.
# merge_max_* MergeTree 表设置
> ClickHouse MergeTree 表设置，属于自动生成的 merge_max_* 分组。
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
版本历史
{headers.map(header => |
{header}
| )}
{rows.map((row, row_index) =>
{(row.items ?? []).map((item, item_index) => |
{item?.label}
| )}
)}
;
};
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
类型
{type}
默认值
{default_value}
{changeable_without_restart &&
无需重启即可更改
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
这些设置见于 [system.merge\_tree\_settings](/zh/reference/system-tables/merge_tree_settings)，并由 ClickHouse 源代码自动生成。
## merge\_max\_block\_size
从已合并的 分片 中读入内存的行数。
可能的值：
* 任意正整数。
合并 会按每块 `merge_max_block_size` 行从 分片 中读取数据行，
然后进行合并，并将结果写入一个新的 分片。读取的块会放入 RAM 中，
因此 `merge_max_block_size` 会影响合并所需的 RAM 大小。
所以，对于行非常宽的表，合并 可能会消耗大量 RAM
(如果平均每行大小为 100kb，那么在合并 10 个 分片 时，
(100kb \* 10 \* 8192) = 约 8GB RAM) 。减小 `merge_max_block_size`
可以减少一次 合并 所需的 RAM，但会降低 合并 速度。
## merge\_max\_block\_size\_bytes
合并操作中生成的块应包含多少字节的数据。默认情况下，
其值与 `index_granularity_bytes` 相同。
## merge\_max\_bytes\_to\_prewarm\_cache
仅在 ClickHouse Cloud 中可用。合并期间用于预热缓存的分片 (compact 或 packed) 的最大大小。
## merge\_max\_dynamic\_subcolumns\_in\_compact\_part
该设置用于限定合并后每个 Compact 数据分片中每一列可创建的动态子列最大数量。
无论数据类型中指定了哪些动态参数，它都可以控制 Compact 数据分片中的动态子列数量。
例如，如果表中某一列的类型为 JSON(max\_dynamic\_paths=1024)，并且将设置 merge\_max\_dynamic\_subcolumns\_in\_compact\_part 设为 128，
那么在合并到 Compact 数据分片后，该分片中的动态路径数量将减少到 128，并且只会有 128 个路径作为动态子列写入。
## merge\_max\_dynamic\_subcolumns\_in\_wide\_part
每一列在合并后于 Wide 数据分片中可创建的动态子列最大数量。
该设置可减少 Wide 数据分片中生成的文件数量，而不受数据类型中指定的动态参数影响。
例如，如果表中有一列的类型为 JSON(max\_dynamic\_paths=1024)，并且将设置 merge\_max\_dynamic\_subcolumns\_in\_wide\_part 设为 128，
那么在合并为 Wide 数据分片后，该数据分片中的动态路径数量将减少到 128，并且只有 128 条路径会作为动态子列写入。