CONFIGURATION PARAMETER连接和认证 / 连接设置

reserved_connections

设置为具有 pg_use_reserved_connections 权限的角色保留的连接槽数量。

Sets the number of connection slots reserved for roles with privileges of pg_use_reserved_connections.

整数重启生效引入 16 现存至 20 devel 0 次默认值变更

类型: 整数integer
上下文: 重启生效只能在服务器启动时设置，修改后需要重启
默认值: 0
取值范围: 0 – 262143
分类: 连接和认证 / 连接设置
引入版本: 16
状态: 现存

PostgreSQL 18 手册官方文档引入提交 6e2775e4d4

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

0 16 – 20

默认值自 PostgreSQL 16 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

确定为拥有 pg_use_reserved_connections 角色的连接保留多少个连接“槽”。当空闲连接槽的数量大于 superuser_reserved_connections，但小于或等于superuser_reserved_connections与 reserved_connections之和时，新连接将只接受超级用户以及拥有 pg_use_reserved_connections权限的角色。如果可用连接槽的数量等于或少于 superuser_reserved_connections，则新连接只接受超级用户。

默认值为零连接。该值必须小于 max_connections减去 superuser_reserved_connections。此参数只能在服务器启动时设置。

机制详解

reserved_connections：设置为具有 pg_use_reserved_connections 权限的角色保留的连接槽数量。这些槽位只向获授 pg_use_reserved_connections 的角色开放，位于普通容量之上、超级用户专用预留之下。

reserved_connections 属于 POSTMASTER 上下文：PostgreSQL 在服务器启动时读取它，重新加载配置或会话 SET 都不能使新值生效。

reserved_connections 与 superuser_reserved_connections 从 max_connections 中划出特权层；连接池、监控、复制、维护与故障转移必须共同纳入同一后端总预算。

调优建议

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

OLTP在线事务处理

在 max_connections 总量内，按独立应急主体数量、连接池行为与故障转移操作确定 reserved_connections；测试普通连接饱和后管理入口仍可用。
OLAP分析与批处理

为重型分析会话之外的控制、监控与取消预留足够槽位，但不要让预留吞噬本就较小后端池的过高比例。
小规格低配实例与开发机

让 reserved_connections 相对 max_connections 保持适度，同时至少保留一条经过测试的应急路径；饱和时预留槽不会供普通客户端使用。

常见问题

期待重新加载或 SET 激活 reserved_connections，而它实际需要受控重启服务器。
把预留槽计算在 max_connections 之外，而所有层级实际共享同一总上限。
应急响应预留过少，或预留过多以致饱和时普通应用容量骤降。
规划普通、预留与超级用户预留槽时，没有确保总量纳入 max_connections。

演化历史

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

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 16 ← 15 新增此参数

PostgreSQL 16 起可用

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
16	`0`	`—`	`重启生效`	`整数`	`0`	`262143`	`—`
17	`0`	`—`	`重启生效`	`整数`	`0`	`262143`	`—`
18	`0`	`—`	`重启生效`	`整数`	`0`	`262143`	`—`
19	`0`	`—`	`重启生效`	`整数`	`0`	`262143`	`—`
20 沿用	`0`	`—`	`重启生效`	`整数`	`0`	`262143`	`—`

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Connections and Authentication 连接和认证 11 个 ↗
连接设置 11
`bonjour`	布尔	重启生效	`off`	—
启用通过 Bonjour 广播服务器。				现存
`bonjour_name`	字符串	重启生效	`空字符串`	—
设置 Bonjour 服务名称。				现存
`listen_addresses`	字符串	重启生效	`localhost`	—
设置服务器监听的主机名或 IP 地址。				现存
`max_connections`	整数	重启生效	`100`	9.62 次
设置数据库并发连接的最大数量。				现存
`port`	整数	重启生效	`5432`	—
设置服务器监听的 TCP 端口。				现存
`reserved_connections`	整数	重启生效	`0`	—
设置为具有 pg_use_reserved_connections 权限的角色保留的连接槽数量。				现存
`superuser_reserved_connections`	整数	重启生效	`3`	9.62 次
设置为超级用户保留的连接槽数量。				现存
`unix_socket_directories`	字符串	重启生效	`/var/run/postgresql`	—
设置创建 Unix 域套接字的目录。				现存
`unix_socket_directory`	字符串	重启生效	`空字符串`	—
设置创建 Unix 域套接字的目录。				于 9.3 移除
`unix_socket_group`	字符串	重启生效	`空字符串`	—
设置 Unix 域套接字的所属组。				现存
`unix_socket_permissions`	整数	重启生效	`511`	—
设置 Unix 域套接字的访问权限。				现存

快速链接