CONFIGURATION PARAMETER开发者选项
force_parallel_mode
强制使用并行查询设施。
Forces use of parallel query facilities.
枚举 会话 引入 9.6 于 16 移除 0 次默认值变更
版本轨迹
相对 PostgreSQL 14 无变化。
默认值变迁
默认值自 PostgreSQL 9.6 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本站未收录 PostgreSQL 15 手册，以下为 PostgreSQL 10 的译文。
允许为测试目的使用并行查询，即使预期不会带来性能收益。 force_parallel_mode允许的值包括 off（仅在预期能提高性能时使用并行模式）、 on（对所有被认为可以安全并行的查询强制使用并行查询），以及 regress（类似于on，但还有下文说明的额外行为变化）。
更具体地说，将此值设置为on会在任何看起来可以安全并行的查询计划顶部添加一个Gather节点， 让查询在并行工作者中运行。即使没有可用的并行工作者或无法使用并行工作者， 在并行查询上下文中不允许的操作（例如启动子事务）也会被禁止，除非规划器认为这会使查询失败。 如果设置此选项后出现失败或意外结果，查询使用的某些函数可能需要被标记为PARALLEL UNSAFE （也可能是PARALLEL RESTRICTED）。
将此值设置为regress具有设置为on的所有效果，另外还有一些旨在方便自动回归测试的效果。 通常，来自并行工作者的消息会包含一行说明这一点的上下文信息，但regress设置会抑制此行，使输出与非并行执行时相同。 此外，此设置添加到计划中的Gather节点会在EXPLAIN输出中隐藏， 使输出与此设置为off时的输出一致。
机制详解
PG15 及以前，force_parallel_mode 会让原本安全的查询在 Gather 下运行，以便即使没有预期加速也测试并行模式行为；regress 会抑制回归测试输出差异。
它不会让不安全查询变安全，并且即使没有 worker 实际运行，也可能施加并行上下文限制；顶层 Gather 是诊断开销，不是计划 hint。
PostgreSQL 16 移除该 GUC，并以 debug_parallel_query 承担测试用途。升级配置必须删除旧名称，也不应在生产中自动开启替代项。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
当前 PostgreSQL 不应配置 force_parallel_mode。升级时删除；即使存在后继参数，也只能用于同类受控开发测试，不能成为生产默认。
-
OLAP分析与批处理
分析负载不能成为保留已移除 force_parallel_mode 的理由；当前版本应使用受支持 EXPLAIN、日志或文档化替代项诊断。
-
小规格低配实例与开发机
现代配置中删除 force_parallel_mode。未知参数导致的启动失败与诊断开销远大于历史用途。
常见问题
- 限时诊断或恢复任务结束后仍让 force_parallel_mode 保持启用。
- 在生产数据的唯一副本上进行实验。
- 低估日志、core、临时文件、WAL、CPU 或连接名额放大。
- 把服务器能启动或查询能完成误当作数据与行为正确的证明。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 16 ← 15 移除此参数
该版起不再存在
-
PostgreSQL 14 ← 13 仅描述更新
分类
Query Tuning / Other Planner OptionsDeveloper Options -
PostgreSQL 9.6 ← 9.5 新增此参数
PostgreSQL 9.6 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
allow_in_place_tablespaces |
布尔 | 会话（超级用户） | off |
— | |
| 允许在 pg_tblspc 内直接创建 tablespace，用于测试。 | 现存 | ||||
allow_system_table_mods |
布尔 | 会话（超级用户） | off |
131 次 | |
| 允许修改系统表的结构。 | 现存 | ||||
backtrace_functions |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 当指定函数中发生错误时记录调用栈。 | 现存 | ||||
debug_discard_caches |
整数 | 会话（超级用户） | 0 |
— | |
| 为调试而激进地使系统目录缓存失效。 | 现存 | ||||
debug_io_direct |
字符串 | 重启生效 | 空字符串 |
— | |
| 为指定文件访问使用直接 I/O。 | 现存 | ||||
debug_logical_replication_streaming |
枚举 | 会话 | buffered |
— | |
| 强制大型事务立即流式发送或序列化变更。 | 现存 | ||||
debug_parallel_query |
枚举 | 会话 | off |
— | |
| 为测试而强制规划器使用并行查询节点。 | 现存 | ||||
force_parallel_mode |
枚举 | 会话 | off |
— | |
| 强制使用并行查询设施。 | 于 16 移除 | ||||
ignore_checksum_failure |
布尔 | 会话（超级用户） | off |
— | |
| 校验和失败后仍继续处理。 | 现存 | ||||
ignore_invalid_pages |
布尔 | 重启生效 | off |
— | |
| 恢复遇到无效页面引用后仍继续。 | 现存 | ||||
ignore_system_indexes |
布尔 | 连接时 | off |
— | |
| 读取系统表时忽略系统索引。 | 现存 | ||||
jit_debugging_support |
布尔 | 连接时（超级用户） | off |
— | |
| 向调试器注册 JIT 生成的函数。 | 现存 | ||||
jit_dump_bitcode |
布尔 | 会话（超级用户） | off |
— | |
| 将 LLVM 位码写盘以便调试 JIT。 | 现存 | ||||
jit_expressions |
布尔 | 会话 | on |
— | |
| 允许 JIT 编译表达式。 | 现存 | ||||
jit_profiling_support |
布尔 | 连接时（超级用户） | off |
— | |
| 向 perf 分析器注册 JIT 生成的函数。 | 现存 | ||||
jit_tuple_deforming |
布尔 | 会话 | on |
— | |
| 允许 JIT 编译元组拆解。 | 现存 | ||||
post_auth_delay |
整数 | 连接时 | 0 s |
— | |
| 设置连接认证完成后的调试等待时间。 | 现存 | ||||
pre_auth_delay |
整数 | 重载生效 | 0 s |
— | |
| 设置连接认证开始前的调试等待时间。 | 现存 | ||||
remove_temp_files_after_crash |
布尔 | 重载生效 | on |
— | |
| 控制后端崩溃后是否删除临时文件。 | 现存 | ||||
send_abort_for_crash |
布尔 | 重载生效 | off |
— | |
| 后端崩溃后向其他子进程发送 SIGABRT 而非 SIGQUIT。 | 现存 | ||||
send_abort_for_kill |
布尔 | 重载生效 | off |
— | |
| 终止卡住的子进程时发送 SIGABRT 而非 SIGKILL。 | 现存 | ||||
trace_connection_negotiation |
布尔 | 重启生效 | off |
— | |
| 记录认证前连接握手的详细信息。 | 现存 | ||||
trace_notify |
布尔 | 会话 | off |
— | |
| 为 LISTEN 和 NOTIFY 生成调试输出。 | 现存 | ||||
trace_recovery_messages |
枚举 | 重载生效 | log |
— | |
| 控制恢复相关调试消息的日志级别。 | 于 17 移除 | ||||
trace_sort |
布尔 | 会话 | off |
— | |
| 输出排序操作的资源使用信息。 | 现存 | ||||
wal_consistency_checking |
字符串 | 会话（超级用户） | 空字符串 |
— | |
| 设置要执行 WAL 一致性检查的资源管理器。 | 现存 | ||||
zero_damaged_pages |
布尔 | 会话（超级用户） | off |
— | |
| 遇到损坏页面头时把内存中的页面清零后继续。 | 现存 | ||||