> ## 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.
# max_bytes_* 会话设置
> ClickHouse 中 max_bytes_* 自动生成分组的会话设置。
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.settings](/zh/reference/system-tables/settings) 中找到，并由 [源代码](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) 自动生成。
## max\_bytes\_before\_external\_group\_by
Cloud 默认值：每个副本内存总量的一半。
控制是否在外部内存中执行 `GROUP BY` 子句。
(参见 [外部内存中的 GROUP BY](/zh/reference/statements/select/group-by#group-by-in-external-memory))
可能的值：
* 单次 [GROUP BY](/zh/reference/statements/select/group-by) 操作可使用的最大 RAM 容量 (以字节为单位) 。
* `0` — 禁用外部内存中的 `GROUP BY`。
如果 GROUP BY 操作期间的内存使用量超过此阈值 (以字节为单位) ，
则会启用“外部聚合”模式 (将数据落盘) 。
建议值为可用系统内存的一半。
## max\_bytes\_before\_external\_join
如果设置为非零值，且 `join_algorithm` 为 `hash`、`parallel_hash`、`default` 或 `auto`，当右侧数据超过该字节数时，哈希 JOIN 会自动转换为 grace hash join，以支持落盘。设置为 `0` (默认值) 时，此绝对字节阈值将被禁用，但仍可能通过 `max_bytes_ratio_before_external_join` (其默认值为 `0.5`) 自动落盘；将两者都设为 `0` 可完全禁用自动落盘。它会阻止通过 JOIN 优化实现的 read in order。
## max\_bytes\_before\_external\_sort
Cloud 默认值：每个副本内存的一半。
启用或禁用使用外部内存执行 `ORDER BY` 子句。参见 [ORDER BY 实现细节](/zh/reference/statements/select/order-by#implementation-details)
如果 ORDER BY 操作期间的内存使用量超过此阈值 (以字节为单位) ，就会启用“外部排序”模式 (将数据落盘到磁盘) 。
可能的值：
* 单次 [ORDER BY](/zh/reference/statements/select/order-by) 操作可使用的最大 RAM 量 (以字节为单位) 。
建议值为可用系统内存的一半
* `0` — 禁用使用外部内存执行 `ORDER BY`。
## max\_bytes\_before\_remerge\_sort
对于带有 LIMIT 的 ORDER BY，当内存使用量超过指定阈值时，会在最终合并前额外执行几步块合并，以便只保留前 LIMIT 行。
## max\_bytes\_for\_lazy\_final
lazy FINAL 优化中集合的最大字节数。超过该值时，将回退到普通 FINAL。
## max\_bytes\_in\_distinct
使用 DISTINCT 时，哈希表在内存中使用的状态的最大字节数
(按未压缩字节计算) 。
## max\_bytes\_in\_join
用于表连接时右侧数据结构 (通常是哈希表) 的最大字节数。
此设置适用于 [SELECT ... JOIN](/zh/reference/statements/select/join) 操作以及 [Join table engine](/zh/reference/engines/table-engines/special/join)。
如果一个查询包含多个 JOIN，ClickHouse 会对每个中间结果检查此设置。达到限制时，具体行为取决于所选的 [`join_algorithm`](/zh/reference/settings/session-settings/join#join_algorithm)——请参阅该设置，了解各算法对应的行为 (落盘、重新分区、切换，或根据 [`join_overflow_mode`](/zh/reference/settings/session-settings/join#join_overflow_mode) 执行 throw/break) 。
可能的值：
* 正整数。
* 0 — 禁用内存控制。
## max\_bytes\_in\_set
由子查询创建的 IN 子句中的 Set 所使用的最大字节数 (按未压缩数据计算) 。
## max\_bytes\_ratio\_before\_external\_group\_by
可用于 `GROUP BY` 的可用内存占比。达到该比例后，
将使用外部内存进行聚合。
例如，如果设置为 `0.6`，`GROUP BY` 在执行开始时将允许使用 60% 的可用内存
(相对于 server/user/merges 可用的内存) ，之后将
开始使用外部聚合。
## max\_bytes\_ratio\_before\_external\_join
允许 `JOIN` 使用的可用内存比例。达到该比例后，哈希 JOIN 会转换为 grace hash join，并将右侧数据落盘到磁盘。
例如，如果设置为 `0.6`，则在执行开始时，`JOIN` 允许右侧哈希表使用可用内存 (对 server/user/merges 可用) 的 `60%`；之后将开始落盘到磁盘。
如果同时设置了 `max_bytes_before_external_join` 和 `max_bytes_ratio_before_external_join`，则使用较小的结果阈值。如果该比例为 `0`，则仅应用绝对值设置。
仅当 `join_algorithm` 为 `hash`、`parallel_hash`、`default` 或 `auto`，且已配置临时数据路径时，此设置才生效。
## max\_bytes\_ratio\_before\_external\_sort
可供 `ORDER BY` 使用的可用内存比例。达到该比例后，将使用外部排序。
例如，如果设置为 `0.6`，则在执行开始时，`ORDER BY` 可使用 `60%` 的可用内存 (对 server/user/merges 而言) ；超过该比例后，将开始使用外部排序。
请注意，`max_bytes_before_external_sort` 仍然有效，只有当排序块大于 `max_bytes_before_external_sort` 时才会落盘。
## max\_bytes\_to\_read
运行查询时，从表中可读取的最大字节数 (未压缩数据) 。
该限制会对每个已处理的数据块检查一次，仅适用于最内层的表表达式；从远程服务器读取时，则只在远程服务器上检查。
## max\_bytes\_to\_read\_leaf
运行分布式查询时，在叶节点上从本地表中可读取的最大字节数 (未压缩数据) 。虽然分布式查询可以向每个分片 (叶) 发出多个子查询，但此限制只会在叶节点的读取阶段进行检查，在根节点的结果合并阶段会被忽略。
例如，一个集群由 2 个分片组成，每个分片都包含一张有 100 字节数据的表。对于一个需要从这两张表中读取全部数据的分布式查询，如果设置 `max_bytes_to_read=150`，则会失败，因为总共需要读取 200 字节。而设置 `max_bytes_to_read_leaf=150` 的查询则会成功，因为叶节点最多只会读取 100 字节。
该限制会对每个已处理的数据块进行检查。
当 `prefer_localhost_replica=1` 时，此设置不稳定。
## max\_bytes\_to\_sort
进行排序前允许处理的最大字节数。如果 ORDER BY 操作需要处理的未压缩字节数
超过指定数量，则其行为由 `sort_overflow_mode` 决定；该参数默认设置为 `throw`。
## max\_bytes\_to\_transfer
在执行 GLOBAL IN/JOIN 部分时，可传输到远程服务器或保存到临时表的最大字节数 (未压缩数据) 。