hash_mem_multiplier

手册说明

PostgreSQL 18 手册 · 19.4 资源消耗 本站手册 官方原文 ↗

本版译文与 PostgreSQL 16 完全一致，下面就是同一段文字。

机制详解

哈希表内存上限等于 work_mem 乘以 hash_mem_multiplier。它作用于哈希连接、哈希聚合、Memoize 节点及其他哈希执行工作，但不会扩大排序操作的上限。

在 PG9.0–19 Beta 3 实测清单中，该参数首次出现于 PostgreSQL 13。其启动默认值在 PostgreSQL 13–14 为 1.0，从 PostgreSQL 15 起为 2.0。

一条查询可以包含多个哈希操作，并行工作进程也可能分别执行自己的操作，因此这个乘积仍是单操作上限，而不是整条查询的总内存上限。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

• OLTP在线事务处理

  保留上游默认值，或仅在确认哈希操作持续落盘后小幅提高。必须结合 work_mem 与峰值活跃计划评估乘积，不能孤立调倍数。

• OLAP分析与批处理

  当内存确实充足时，较高取值可帮助大型哈希连接与聚合。应在受控并发上限下增加，并比较批次数、落盘量与端到端耗时。

• 小规格低配实例与开发机

  保持接近默认值。很高的倍数会把看似克制的 work_mem 变成每个哈希操作数百 MiB。

常见问题

• 把数值当绝对内存大小，而不是 work_mem 的倍数。
• 忘记 PostgreSQL 13 之前没有该参数，且 PostgreSQL 15 修改了上游默认值。
• 期待它改善排序；排序仍受 work_mem 控制。
• 一条查询存在多个哈希节点或并行工作进程时，却只计算一次乘数。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 17 ← 16 仅描述更新

   简述 Multiple of work_mem to use for hash tables. → Multiple of "work_mem" to use for hash tables.

3. PostgreSQL 15 ← 14 默认值变更

   默认值 1 → 2

4. PostgreSQL 13 ← 12 新增此参数

   +PostgreSQL 13 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

关联参数

work_memtemp_file_limitenable_hashjoinenable_hashaggmax_parallel_workers_per_gather

参考资料

• PostgreSQL 19 Beta 3：hash_mem_multiplier
• PostgreSQL 19 发行说明

同类参数