CONFIGURATION PARAMETER连接和认证 / TCP 设置
tcp_keepalives_interval
设置 TCP keepalive 重传之间的间隔。
Time between TCP keepalive retransmits.
整数 会话 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
0 s原始值 0 s- 取值范围
0 – 2147483647- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 14 完全一致，下面就是同一段文字。
指定未被客户端确认收到的 TCP keepalive 消息在多久之后应被重传。 如果指定值时没有单位，则以秒为单位。值 0（默认值）表示选择操作系统默认值。 在 Windows 上，将该值设为 0 会把此参数设为 1 秒，因为 Windows 不提供读取系统默认值的方法。 这个参数只有在支持 TCP_KEEPINTVL 或等效套接字选项的系统以及 Windows 上才可用； 在其他系统上，它必须为零。在通过 Unix 域套接字连接的会话中，这个参数会被忽略，并始终读作零。
机制详解
tcp_keepalives_interval：设置 TCP keepalive 重传之间的间隔。探测开始后，它规定重传间隔，并与 tcp_keepalives_count 共同决定总故障发现时间。
tcp_keepalives_interval 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。
有效故障发现窗口由 tcp_keepalives_idle、tcp_keepalives_interval 与 tcp_keepalives_count 共同推导，并受操作系统支持及更短网络设备超时约束。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
把 tcp_keepalives_interval 与其他 keepalive 控制联合选择，使总故障发现时间符合负载均衡、故障转移与重试预算，并确认操作系统实现对应套接字选项。
-
OLAP分析与批处理
长分析连接的 keepalive 应短于中间网络设备的空闲过期时间，但不能激进到因短暂丢包终止健康作业。
-
小规格低配实例与开发机
除非实测网络故障模式要求覆盖，否则使用操作系统默认值；应整体调节 idle/interval/count，而不是只调 tcp_keepalives_interval。
常见问题
- 只在一个会话中修改 tcp_keepalives_interval，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
- 只调一个 keepalive 组成项，却未计算完整空闲加重传故障窗口。
- 误以为 PostgreSQL 请求值能覆盖不支持的平台，或更短的防火墙与负载均衡空闲策略。
- 只调重传间隔，却未结合 tcp_keepalives_count 与总故障发现时间。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
补充说明
A value of 0 uses the system default.0 means use the system default. -
PostgreSQL 16 ← 15 仅描述更新
分类
Connections and Authentication / Connection SettingsConnections and Authentication / TCP Settings -
PostgreSQL 14 ← 13 仅描述更新
分类
Client Connection Defaults / Other DefaultsConnections and Authentication / Connection Settings
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 9.1 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 9.2 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 9.3 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 9.4 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 9.5 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 9.6 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 10 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 11 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 12 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 13 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 14 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 15 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 16 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 17 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 18 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 19 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
| 20 沿用 | 0 s |
s |
会话 |
整数 |
0 |
2147483647 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 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 用户超时。 | 现存 | ||||