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

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

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

CONFIGURATION PARAMETER开发者选项

trace_notify

为 LISTEN 和 NOTIFY 生成调试输出。

Generates debugging output for LISTEN and NOTIFY.

布尔 会话 引入 9.0(基线) 现存至 20 devel 0 次默认值变更

类型
布尔bool
上下文
会话任何用户都可在会话内用 SET 修改
默认值
off
引入版本
9.0(基线)
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

off 9.0 – 20

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

手册说明

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

LISTENNOTIFY命令生成大量调试输出。client_min_messageslog_min_messages必须是DEBUG1或者更低才能把这种输出分别发送到客户端或者服务器日志。

机制详解

trace_notify 为 LISTEN 与 NOTIFY 输出大量内部调试消息;只有 client_min_messages 或 log_min_messages 包含 DEBUG1 或更低级别时才可见。

它追踪实现活动,并不是通知 payload 的持久审计;额外消息量可能远大于应用通知流。

应只在受控会话中复现队列与投递 bug。队列容量与清理由 max_notify_queue_pages 和监听者事务行为另行控制。其 user 上下文允许按会话或事务局部修改,之后执行或重新规划的工作会读取新值。

调优建议

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

  • OLTP在线事务处理

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

  • OLAP分析与批处理

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

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

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

常见问题

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

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
9.0 off 会话 布尔
9.1 off 会话 布尔
9.2 off 会话 布尔
9.3 off 会话 布尔
9.4 off 会话 布尔
9.5 off 会话 布尔
9.6 off 会话 布尔
10 off 会话 布尔
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
遇到损坏页面头时把内存中的页面清零后继续。 现存