↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

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

百科 / 连接参数 / 超时与保活

tcp_user_timeout

控制已发送数据最多可保持未确认状态多少毫秒,超过后强制关闭连接。零表示使用系统默认值。通过 Unix 域套接字连接时,此参数被忽略。仅在提供 TCP_USER_TIMEOUT 的系统上支持;其他系统中无效。

当前查看 PostgreSQL 18.6。

说明

控制已发送数据最多可保持未确认状态多少毫秒,超过后强制关闭连接。零表示使用系统默认值。通过 Unix 域套接字连接时,此参数被忽略。仅在提供 TCP_USER_TIMEOUT 的系统上支持;其他系统中无效。

客户端库
libpq 18.6
手册定义
手册已记载
源码中的环境变量回退
选项表中未声明
编译时回退表达式
NULL

用法

tcp_user_timeout

默认值解析与服务文件优先级

以下环境变量可用于选择连接参数的默认值,供 PQconnectdb 、 PQsetdbLogin 和 PQsetdb 在调用代码未直接指定参数值时使用。例如,这样可以避免在简单的客户端应用程序中硬编码数据库连接信息。

服务名称可以在每个用户的服务文件或系统范围的文件中定义。如果同一个服务名称存在于用户文件和系统文件中,则用户文件优先。默认情况下,每个用户的服务文件名为 ~/.pg_service.conf 。在Microsoft Windows上,它的名称为 %APPDATA%\postgresql\.pg_service.conf (其中 %APPDATA% 指用户配置文件夹中的应用数据子目录)。可以通过设置环境变量 PGSERVICEFILE 来指定不同的文件名。系统范围的文件名为 pg_service.conf 。默认情况下,在 PostgreSQL 安装的 etc 目录中寻找(使用 pg_config --sysconfdir 来准确识别此目录)。可以通过设置环境变量 PGSYSCONFDIR 来指定另一个目录,但不能指定不同的文件名。

从服务文件中获取的连接参数会与其他来源的参数合并。服务文件中的设置会覆盖相应的环境变量,而连接字符串中直接给出的值又会覆盖服务文件中的设置。例如,使用上述服务文件时,连接字符串 service=mydb port=5434 将使用主机 somehost 、端口 5434 、用户 admin ,以及由环境变量或内置默认值设置的其他参数。

环境变量证据

手册定义

tcp_user_timeout

控制已发送数据最多可保持未确认状态多少毫秒,超过后强制关闭连接。零表示使用系统默认值。通过 Unix 域套接字连接时,此参数被忽略。仅在提供 TCP_USER_TIMEOUT 的系统上支持;其他系统中无效。

相关条目

文档与源码

来源构建
版本
18.6
构建
https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
来源指纹
ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8

版本比较

PostgreSQL 11 → 12: 新增收录。

以下差异保留原始字段名与英文源描述。

--- PostgreSQL 11
+++ PostgreSQL 12
@@ -1 +1,10 @@
-该版未收录
+{
+  "compiled_default_expression": "NULL",
+  "default_evidence": [
+    "Controls the number of milliseconds that transmitted data may remain unacknowledged before a connection is forcibly closed. A value of zero uses the system default. This parameter is ignored for connections made via a Unix-domain socket. It is only supported on systems where TCP_USER_TIMEOUT is available; on other systems, it has no effect."
+  ],
+  "definition": "Controls the number of milliseconds that transmitted data may remain unacknowledged before a connection is forcibly closed. A value of zero uses the system default. This parameter is ignored for connections made via a Unix-domain socket. It is only supported on systems where TCP_USER_TIMEOUT is available; on other systems, it has no effect.",
+  "documented": true,
+  "environment": "",
+  "keyword": "tcp_user_timeout"
+}

比较已记录的接口与属性,排除来源指纹和构建元数据。某个样本中没有记录,不能据此判断实际引入或移除的版本。

相关条目

导出 JSON · 返回连接参数 · 收录范围为 PostgreSQL 12 至 20;最早采样版本不一定是实际引入版本。