CONFIGURATION PARAMETER连接和认证 / TCP 设置
client_connection_check_interval
设置查询运行期间检查客户端断连的时间间隔。
Sets the time interval between checks for disconnection while running queries.
整数 会话 引入 14 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
0 ms原始值 0 ms- 取值范围
0 – 2147483647- 引入版本
- 14
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值自 PostgreSQL 14 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
在运行查询时，设置检查客户端是否保持连接的可选检查的时间间隔。 这个检查通过轮询套接字来执行，并且在内核报告该连接关闭时，允许长时间运行的查询可以尽快中止。
这个选项依赖于Linux、macOS、illumos和BSD家族操作系统暴露的内核事件， 目前在其他系统上不可用。
如果指定的值没有单位，则以毫秒为单位。 默认值为0，代表禁用连接检查。 没有连接检查，服务器将只在与套接字的下一次交互时检测连接的丢失，当它等待、接收或发送数据时。
为了让内核本身能够在包括网络故障在内的所有场景中，在已知的时间范围内可靠地检测丢失的TCP连接，它可能还需要调整操作系统的TCP保持连接设置， 或者PostgreSQL的tcp_keepalives_idle, tcp_keepalives_interval 和 tcp_keepalives_count 设置。
机制详解
client_connection_check_interval：设置查询运行期间检查客户端断连的时间间隔。非零间隔让长查询在下一次套接字写入前发现客户端已断开；检查是否有效取决于操作系统支持。
client_connection_check_interval 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。
多个超时会重叠，最先到期的适用期限获胜；客户端、连接池、TCP 与服务器取消行为决定工作被重试、取消还是关闭会话。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
只有客户端丢失后放弃工作能显著节省容量且平台支持检查时，才为 client_connection_check_interval 使用非零值；应测量所选间隔的轮询开销。
-
OLAP分析与批处理
长分析查询可从周期断连检测获益，避免客户端消失后继续运行；该间隔并不限制健康查询的执行时长。
-
小规格低配实例与开发机
除非观察到孤儿长查询，否则保持零；启用时选择既能发现浪费又不过度检查活动查询的间隔。
常见问题
- 只在一个会话中修改 client_connection_check_interval，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
- 忘记零通常表示禁用超时或把行为交给操作系统。
- 设置重叠期限，却未明确哪个层负责重试、取消与连接丢弃。
- 没有回滚计划及客户端或运维兼容测试，就全局修改 client_connection_check_interval。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
补充说明
（无）0 disables connection checks. -
PostgreSQL 16 ← 15 仅描述更新
分类
Connections and Authentication / Connection SettingsConnections and Authentication / TCP Settings -
PostgreSQL 14 ← 13 新增此参数
PostgreSQL 14 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| TCP 设置 5 | |||||
client_connection_check_interval |
整数 | 会话 | 0 ms |
— | |
| 设置查询运行期间检查客户端断连的时间间隔。 | 现存 | ||||
tcp_keepalives_count |
整数 | 会话 | 0 |
— | |
| 设置 TCP keepalive 的最大重传次数。 | 现存 | ||||
tcp_keepalives_idle |
整数 | 会话 | 0 s |
— | |
| 设置开始发送 TCP keepalive 前的空闲时间。 | 现存 | ||||
tcp_keepalives_interval |
整数 | 会话 | 0 s |
— | |
| 设置 TCP keepalive 重传之间的间隔。 | 现存 | ||||
tcp_user_timeout |
整数 | 会话 | 0 ms |
— | |
| 设置 TCP 用户超时。 | 现存 | ||||