跳转到主要内容

force_parallel_mode

force_parallel_mode:强制使用并行查询设施。实测在档范围为 PG9.6–15;最后在档的 PG15 启动默认值为 off,context 为 user。它在 PG16 被移除。
说明

Fact — 官方简述译文:强制使用并行查询设施。

身份

类型 , enum
上游 pg_settings 类型
Context , user
普通用户可在运行时修改
单位 ,
原始单位
范围 ,
最后在档版本的原始上下限
枚举值 , off, on, regress
非枚举类型记为 —
分类 , Developer Options
上游分类
最后 boot 值 , off
off

生命周期

Fact
首次观测 PG9.6
在档版本 PG9.6–15
移除版本 PG16
引入提交 7c944bd90339 — Introduce a new GUC force_parallel_mode for testing purposes.
提交日期 2016-02-07
Discussion

默认值变迁

PG9.0–19 Beta 3 实测 boot 默认值
版本 原始 boot_val 单位 人类可读值
PG9.6–15 off off

机制详解

PG15 及以前,force_parallel_mode 会让原本安全的查询在 Gather 下运行,以便即使没有预期加速也测试并行模式行为;regress 会抑制回归测试输出差异。

它不会让不安全查询变安全,并且即使没有 worker 实际运行,也可能施加并行上下文限制;顶层 Gather 是诊断开销,不是计划 hint。

PostgreSQL 16 移除该 GUC,并以 debug_parallel_query 承担测试用途。升级配置必须删除旧名称,也不应在生产中自动开启替代项。其 user 上下文允许按会话或事务局部修改,之后执行或重新规划的工作会读取新值。

调优建议

提示

Advice。 以下建议是工作负载起点,必须用真实测量验证。

场景 建议
OLTP 当前 PostgreSQL 不应配置 force_parallel_mode。升级时删除;即使存在后继参数,也只能用于同类受控开发测试,不能成为生产默认。
OLAP 分析负载不能成为保留已移除 force_parallel_mode 的理由;当前版本应使用受支持 EXPLAIN、日志或文档化替代项诊断。
小规格 现代配置中删除 force_parallel_mode。未知参数导致的启动失败与诊断开销远大于历史用途。

Pigsty 取值

以下值来自固定 8 核、32 GiB、100 GiB SSD 夹具,并按 PG15 渲染当前 Pigsty 模板;这不表示 Pigsty 当前支持该历史或测试版本。

模板 有效值 与上游 boot 比较 源表达式
OLTP 未修改
OLAP 未修改
CRIT 未修改
TINY 未修改
注意

Advice — 待人工复核。 当前 Pigsty 模板投影事实:OLTP: PG9.6–15 未修改;OLAP: PG9.6–15 未修改;CRIT: PG9.6–15 未修改;TINY: PG9.6–15 未修改。 未发现覆盖值,因此不推断 Pigsty 专属理由。

常见坑

  • 限时诊断或恢复任务结束后仍让 force_parallel_mode 保持启用。
  • 在生产数据的唯一副本上进行实验。
  • 低估日志、core、临时文件、WAL、CPU 或连接名额放大。
  • 把服务器能启动或查询能完成误当作数据与行为正确的证明。

debug_parallel_query · max_parallel_workers_per_gather · max_parallel_workers · parallel_setup_cost

参考资料