max_bytes_* 会话设置

这些设置可在 system.settings 中找到，并由 源代码 自动生成。

Cloud 默认值：每个副本内存总量的一半。

控制是否在外部内存中执行 GROUP BY 子句。 (参见 外部内存中的 GROUP BY)

可能的值：

• 单次 GROUP BY 操作可使用的最大 RAM 容量 (以字节为单位) 。
• 0 — 禁用外部内存中的 GROUP BY。

如果设置为非零值，且 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。

Cloud 默认值：每个副本内存的一半。

启用或禁用使用外部内存执行 ORDER BY 子句。参见 ORDER BY 实现细节 如果 ORDER BY 操作期间的内存使用量超过此阈值 (以字节为单位) ，就会启用“外部排序”模式 (将数据落盘到磁盘) 。

可能的值：

• 单次 ORDER BY 操作可使用的最大 RAM 量 (以字节为单位) 。 建议值为可用系统内存的一半
• 0 — 禁用使用外部内存执行 ORDER BY。

对于带有 LIMIT 的 ORDER BY，当内存使用量超过指定阈值时，会在最终合并前额外执行几步块合并，以便只保留前 LIMIT 行。

lazy FINAL 优化中集合的最大字节数。超过该值时，将回退到普通 FINAL。

使用 DISTINCT 时，哈希表在内存中使用的状态的最大字节数 (按未压缩字节计算) 。

用于表连接时右侧数据结构 (通常是哈希表) 的最大字节数。

此设置适用于 SELECT … JOIN 操作以及 Join table engine。

如果一个查询包含多个 JOIN，ClickHouse 会对每个中间结果检查此设置。达到限制时，具体行为取决于所选的 join_algorithm——请参阅该设置，了解各算法对应的行为 (落盘、重新分区、切换，或根据 join_overflow_mode 执行 throw/break) 。

可能的值：

• 正整数。
• 0 — 禁用内存控制。

由子查询创建的 IN 子句中的 Set 所使用的最大字节数 (按未压缩数据计算) 。

可用于 GROUP BY 的可用内存占比。达到该比例后， 将使用外部内存进行聚合。

例如，如果设置为 0.6，GROUP BY 在执行开始时将允许使用 60% 的可用内存 (相对于 server/user/merges 可用的内存) ，之后将 开始使用外部聚合。

允许 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，且已配置临时数据路径时，此设置才生效。

可供 ORDER BY 使用的可用内存比例。达到该比例后，将使用外部排序。

例如，如果设置为 0.6，则在执行开始时，ORDER BY 可使用 60% 的可用内存 (对 server/user/merges 而言) ；超过该比例后，将开始使用外部排序。

请注意，max_bytes_before_external_sort 仍然有效，只有当排序块大于 max_bytes_before_external_sort 时才会落盘。

运行查询时，从表中可读取的最大字节数 (未压缩数据) 。 该限制会对每个已处理的数据块检查一次，仅适用于最内层的表表达式；从远程服务器读取时，则只在远程服务器上检查。

运行分布式查询时，在叶节点上从本地表中可读取的最大字节数 (未压缩数据) 。虽然分布式查询可以向每个分片 (叶) 发出多个子查询，但此限制只会在叶节点的读取阶段进行检查，在根节点的结果合并阶段会被忽略。

例如，一个集群由 2 个分片组成，每个分片都包含一张有 100 字节数据的表。对于一个需要从这两张表中读取全部数据的分布式查询，如果设置 max_bytes_to_read=150，则会失败，因为总共需要读取 200 字节。而设置 max_bytes_to_read_leaf=150 的查询则会成功，因为叶节点最多只会读取 100 字节。

该限制会对每个已处理的数据块进行检查。

进行排序前允许处理的最大字节数。如果 ORDER BY 操作需要处理的未压缩字节数 超过指定数量，则其行为由 sort_overflow_mode 决定；该参数默认设置为 throw。

在执行 GLOBAL IN/JOIN 部分时，可传输到远程服务器或保存到临时表的最大字节数 (未压缩数据) 。