CONFIGURATION PARAMETER连接和认证 / 连接设置
max_connections
设置数据库并发连接的最大数量。
Sets the maximum number of concurrent connections.
整数 重启生效 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 重启生效只能在服务器启动时设置，修改后需要重启
- 默认值
100- 取值范围
1 – 262143- 分类
- 连接和认证 / 连接设置
- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 9.0 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 14 完全一致，下面就是同一段文字。
决定数据库服务器允许的最大并发连接数。默认值通常是 100 个连接，但如果内核设置不支持 （在 initdb 期间确定），则可能更少。这个参数只能在服务器启动时设置。
PostgreSQL 会直接根据 max_connections 的值来确定某些资源的规模。 增大该值会导致这些资源（包括共享内存）的分配随之增加。
当运行一个备库时，你必须设置这个参数等于或大于主库上的参数。 否则，备库上可能无法允许查询。
机制详解
max_connections 限制数据库服务器的并发连接数，只能在服务器启动时修改。PostgreSQL 会直接按该值确定部分资源规模，因此即使连接槽未全部使用，调高上限也会增加包括共享内存在内的分配。
reserved_connections 与 superuser_reserved_connections 从同一个总上限中划出应急或特权容量，因此普通应用通常不能占满所有配置槽位。
备用库的取值必须不低于主库。连接池可以把大量客户端连接与较少、受控的 PostgreSQL 后端连接解耦。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
面对大量客户端时优先使用事务池，按峰值活跃数据库工作量，加上监控、维护和故障转移余量来确定后端数；不要默认把每个客户端连接映射为一个服务器槽位。
-
OLAP分析与批处理
分析会话通常更少但更重，应把后端上限控制在能约束 work_mem 与并行工作进程总需求的范围，并为 ETL 与管理预留明确容量。
-
小规格低配实例与开发机
使用较低上限配合连接池并保留应急槽位。验证启动所需共享内存，不要通过不断提高上限掩盖连接泄漏。
常见问题
- 修改后没有安排重启，也没有保证备用库取值至少与主库相同。
- 忽略更高连接上限带来的共享内存与每后端开销。
- 计算应用容量时忘记预留连接与超级用户预留槽。
- 同时使用很高的连接上限和宽松的单操作内存，却认为二者不会相乘。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 9.6 ← 9.5 属性变更
最大值
8388607262143 -
PostgreSQL 9.1 ← 9.0 属性变更
最大值
5368709118388607
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | 100 |
空 |
重启生效 |
整数 |
1 |
536870911 |
— |
| 9.1 | 100 |
空 |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.2 | 100 |
空 |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.3 | 100 |
空 |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.4 | 100 |
空 |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.5 | 100 |
— |
重启生效 |
整数 |
1 |
8388607 |
— |
| 9.6 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 10 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 11 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 12 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 13 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 14 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 15 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 16 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 17 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 18 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 19 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
| 20 沿用 | 100 |
— |
重启生效 |
整数 |
1 |
262143 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 连接设置 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 域套接字的访问权限。 | 现存 | ||||