Activity: CheckpointerShutdown
等待 checkpointer 进程终止。
PostgreSQL 等待事件档案
类别Activity
事件
CheckpointerShutdown
版本PG 18
证据2 个源码位置
官方描述译文
等待 checkpointer 进程终止。
| PG 13 | PG 14 | PG 15 | PG 16 | PG 17 | PG 18 |
|---|---|---|---|---|---|
| — | — | — | — | — | ✓ |
触发机制
WAIT_EVENT_CHECKPOINTER_SHUTDOWN 位于 src/backend/postmaster/checkpointer.c:631,是经 grep 核验的报告路径。公共身份/资源映射位于 src/backend/utils/activity/wait_event_names.txt:59。探针覆盖的操作是:等待 checkpointer 进程终止。CheckpointerShutdown 后台路径在主循环暂时无事可做、进入 latch wait 前报告此事件;信号、计时器或新工作会唤醒进程并进入下一轮循环。
正常还是麻烦?
- 正常: 对匹配的后台进程而言,这通常是预期空闲。
- 需要调查: 只有工作队列、关闭或故障切换时限没有推进但进程一直停在这里,或事件出现在不匹配的后端类型上时,才需要调查。
诊断 SQL
正在等待 Activity/CheckpointerShutdown 的会话
当前 Activity 等待分布
这些会话的锁与关系上下文
处置建议
- 先与 backend_type 对照。
- 检查该进程专属的积压与最后进展时间。
- 修复缺失的工作信号或停滞的上游阶段,不要终止正常空闲的 worker。
源码证据
- PostgreSQL 18.6 · src/backend/postmaster/checkpointer.c:631 —
WAIT_EVENT_CHECKPOINTER_SHUTDOWN - PostgreSQL 18.6 · src/backend/utils/activity/wait_event_names.txt:59 —
CHECKPOINTER_SHUTDOWN
关联控制项与信号
- GUC: [guc:checkpoint_timeout] · [guc:max_wal_size]
- 指标: [metric:waiting_sessions] · [metric:wait_event_share] · [metric:checkpoint_time]