选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

文档 / 配置参数 / 开发者选项

CONFIGURATION PARAMETER开发者选项

jit_debugging_support

向调试器注册 JIT 生成的函数。

Register JIT-compiled functions with debugger.

布尔 连接时(超级用户) 引入 11 现存至 20 devel 0 次默认值变更

类型
布尔bool
上下文
连接时(超级用户)只能在连接建立时由超级用户设置
默认值
off
引入版本
11
状态
现存

PostgreSQL 18 手册 官方文档 引入提交 250bca7fc1

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

off 11 – 20

默认值自 PostgreSQL 11 起没有变过。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18 手册 · 19.17 开发者选项 本站手册 官方原文

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

如果LLVM有所需要的功能,用GDB注册所生成的函数。这会让调试更加容易。默认设置是off。只有超级用户和具有适当SET权限的用户可以在会话开始时更改这个参数,并且在会话内完全不能更改它。

机制详解

jit_debugging_support 在 LLVM 与平台具备所需 listener 接口时,把 JIT 生成函数注册给 GDB,以改善调试器中的符号可见性。

该值在后端启动时固定,并不会开启 JIT;查询仍需 jit、可用 provider 与成本阈值才会生成代码。

注册会增加开发插桩,只在调试 JIT 内部或生成代码时有用,不是查询性能功能。其 superuser-backend 上下文在连接启动时固定,并限制可设置角色。

调优建议

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

  • OLTP在线事务处理

    不要用 jit_debugging_support 调优生产 OLTP。只在有负责人、日志/磁盘预算、回滚条件与取证计划的限时复现中启用,完成后立即恢复默认。

  • OLAP分析与批处理

    长分析任务会放大 jit_debugging_support 的调试开销与生成物。应优先使用标准 EXPLAIN 与统计,并把开发实验与普通用户隔离。

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

    让 jit_debugging_support 保持上游默认。小主机没有足够 CPU、磁盘、连接与日志余量承担开发插桩,更不适合长时间开启。

常见问题

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

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 14 ← 13 仅描述更新

    简述 Register JIT compiled function with debugger. Register JIT-compiled functions with debugger.

  3. PostgreSQL 11 ← 10 新增此参数

    PostgreSQL 11 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
11 off 连接时(超级用户) 布尔
12 off 连接时(超级用户) 布尔
13 off 连接时(超级用户) 布尔
14 off 连接时(超级用户) 布尔
15 off 连接时(超级用户) 布尔
16 off 连接时(超级用户) 布尔
17 off 连接时(超级用户) 布尔
18 off 连接时(超级用户) 布尔
19 off 连接时(超级用户) 布尔
20 沿用 off 连接时(超级用户) 布尔

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Developer Options 开发者选项 27 个
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
遇到损坏页面头时把内存中的页面清零后继续。 现存