tcp_keepalives_count

手册说明

PostgreSQL 18 手册 · 19.3 连接和认证 本站手册 官方原文 ↗

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

机制详解

tcp_keepalives_count：设置 TCP keepalive 的最大重传次数。它与 idle、interval 一起决定多少次未响应探测后判定故障；在支持的平台上，零选择操作系统默认值。

tcp_keepalives_count 属于 USER 上下文。获授权角色可在会话内修改，ALTER ROLE 或 ALTER DATABASE 可为未来会话建立默认值。

有效故障发现窗口由 tcp_keepalives_idle、tcp_keepalives_interval 与 tcp_keepalives_count 共同推导，并受操作系统支持及更短网络设备超时约束。

调优建议

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

• OLTP在线事务处理

  把 tcp_keepalives_count 与其他 keepalive 控制联合选择，使总故障发现时间符合负载均衡、故障转移与重试预算，并确认操作系统实现对应套接字选项。

• OLAP分析与批处理

  长分析连接的 keepalive 应短于中间网络设备的空闲过期时间，但不能激进到因短暂丢包终止健康作业。

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

  除非实测网络故障模式要求覆盖，否则使用操作系统默认值；应整体调节 idle/interval/count，而不是只调 tcp_keepalives_count。

常见问题

• 只在一个会话中修改 tcp_keepalives_count，却认为角色默认值、数据库默认值或其他池化会话也已随之改变。
• 只调一个 keepalive 组成项，却未计算完整空闲加重传故障窗口。
• 误以为 PostgreSQL 请求值能覆盖不支持的平台，或更短的防火墙与负载均衡空闲策略。
• 误以为零表示不探测，而它实际选择操作系统默认值。

演化历史

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

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 18 ← 17 仅描述更新

   补充说明 Number of consecutive keepalive retransmits that can be lost before a connection is considered dead. A value of 0 uses the system default. → Number of consecutive keepalive retransmits that can be lost before a connection is considered dead. 0 means use the system default.

3. PostgreSQL 16 ← 15 仅描述更新

   分类 Connections and Authentication / Connection Settings → Connections and Authentication / TCP Settings

4. PostgreSQL 15 ← 14 仅描述更新

   补充说明 This controls the number of consecutive keepalive retransmits that can be lost before a connection is considered dead. A value of 0 uses the system default. → Number of consecutive keepalive retransmits that can be lost before a connection is considered dead. A value of 0 uses the system default.

5. PostgreSQL 14 ← 13 仅描述更新

   分类 Client Connection Defaults / Other Defaults → Connections and Authentication / Connection Settings

逐版本快照

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

关联参数

tcp_keepalives_idletcp_keepalives_intervaltcp_user_timeoutclient_connection_check_intervalauthentication_timeout

参考资料

• PostgreSQL 19 Beta 3：tcp_keepalives_count
• PostgreSQL 19 发行说明

同类参数