PostgreSQL / 系统课时

验证连接复用效果

验证连接复用效果

本课把“连接池配置生效了”变成可观测证据:同时检查客户端池状态、PgBouncer 的客户端与服务器连接,以及 PostgreSQL 后端会话数量,确认请求增加时是否复用已有连接,而不是持续创建新连接。

学习目标

  • 能从客户端、PgBouncer、PostgreSQL 三侧指标判断连接是否真正复用。
  • 能区分“客户端连接少”和“数据库后端连接少”这两个不同结论。
  • 能用同一时间窗口的快照和请求压测验证连接复用效果,并识别配置失效信号。

三侧指标要看什么

连接复用不能只看 PostgreSQL 的 pg_stat_activity。客户端可能已经限制了池大小,但 PgBouncer 仍可能建立更多服务器连接;反过来,数据库连接数下降也不代表客户端没有长时间等待。验证时要把三侧指标放在同一时间窗口内比较。

客户端、PgBouncer 与 PostgreSQL 的连接复用观测关系

客户端侧重点是池本身的使用状态:池大小、可用连接、等待获取连接的请求,以及获取连接耗时。验证复用时,重点观察请求量上涨后,物理连接数是否仍稳定在池的设计上限附近,而不是跟着请求数线性增长。

若应用使用的是 psycopg_pool,可以直接读取客户端池统计。下面是一个独立观测片段,依赖应用已经创建名为 pool 的 ConnectionPool 实例。

python
stats = pool.get_stats()
print({
    "pool_size": stats.get("pool_size"),
    "pool_available": stats.get("pool_available"),
    "requests_waiting": stats.get("requests_waiting"),
})

预期结果

text
{'pool_size': 8, 'pool_available': 6, 'requests_waiting': 0}

实际字段会随 psycopg_pool 版本和配置略有差异,重点关注池容量、可用连接和等待请求。若等待请求持续增加,即使 PostgreSQL 后端连接数不高,也可能是客户端池容量约束;若可用连接长期接近 0,则应继续结合数据库侧吞吐和单请求持有连接时间判断。

PgBouncer 侧要同时看 client 和 server 两组指标。cl_active、cl_waiting 用于观察客户端是否正在使用或等待服务;sv_active、sv_idle 用于观察当前实际占用和空闲的 PostgreSQL 服务器连接。PostgreSQL 侧使用 pg_stat_activity 查看来自 PgBouncer 的后端会话,它回答的是“数据库当前有多少物理后端连接”,而不是“业务发起了多少次请求”。

用 PgBouncer 和 PostgreSQL 做一次快照

下面假设 PgBouncer 管理控制台监听在 <PORT>,业务数据库端口为 <PORT>。实际端口以环境配置为准。先分别查看 PgBouncer 池状态与 PostgreSQL 会话状态。

bash
psql -h <HOST> -p <PORT> -U <ADMIN_USER> -d pgbouncer -c "SHOW POOLS;"
psql -h <HOST> -p <PORT> -U <DB_USER> -d <DB_NAME> -c "SELECT application_name, state, count(*) AS sessions FROM pg_stat_activity WHERE datname = current_database() GROUP BY application_name, state ORDER BY application_name, state;"

预期结果

text
 database | user      | cl_active | cl_waiting | sv_active | sv_idle | maxwait | maxwait_us
----------+-----------+-----------+------------+-----------+---------+---------+-----------
 <DB_NAME>| <USER>    |         4 |          0 |         2 |       2 |       0 |          0

 application_name | state  | sessions
------------------+--------+---------
 pgbouncer        | idle   |       2
 pgbouncer        | active |       2

这里的具体数字只是示例,实际值会随负载变化。关键关系是:客户端活动量可以高于 PostgreSQL 物理会话数,而 PgBouncer 的服务器连接应受 default_pool_size 等池配置约束,而不是跟请求次数一起无限增长。SHOW POOLS 的实际列集合可能随 PgBouncer 版本变化,验证时以当前版本返回的字段为准,不应把示例列名当成跨版本固定接口。

用重复请求验证请求增长与连接增长是否解耦

单次快照只能证明当前状态。更可靠的方法是在一段时间内持续产生请求,同时周期性采样客户端池、PgBouncer 和 PostgreSQL。下面用一个简单的 pgbench 场景形成稳定请求流;它只用于制造负载,不代表你的生产客户端池实现。

bash
pgbench -h <HOST> -p <PORT> -U <DB_USER> -d <DB_NAME> -T 30 -c 20 -j 4 -S

预期结果

text
scaling factor: 1
number of clients: 20
number of threads: 4
duration: 30 s
number of transactions actually processed: <VALUE>
latency average = <VALUE> ms
tps = <VALUE>

压测期间按固定间隔重复采样客户端池统计,并执行上一节的 SHOW POOLS; 和 PostgreSQL 会话查询。正常复用场景通常表现为请求数和事务数持续增加,但 sv_active + sv_idle 维持在相对稳定的范围;如果请求增长同时伴随 PostgreSQL 后端会话明显增长,应检查客户端是否绕过 PgBouncer、池是否过大,或 PgBouncer 池配置是否未按预期生效。

判断结果是否符合预期

可以用下面的关系快速判读:客户端请求数代表业务使用量,客户端池连接数代表应用侧并发资源,PgBouncer server 连接数代表共享的数据库物理连接。复用的核心特征不是“连接数永远不变”,而是请求规模扩大后,物理连接增长受到明确上限约束。

如果客户端等待持续增加,同时 sv_active 已接近池上限,应优先判断数据库侧吞吐或单连接执行时间是否成为瓶颈;如果客户端连接很多但 PostgreSQL 会话没有进入预期范围,则要检查连接是否真正经过 PgBouncer,以及是否存在绕过池的直连路径。

最终验收至少保留一次低负载和一次高负载快照,并记录采样时刻、请求量、客户端池状态、PgBouncer SHOW POOLS 和 PostgreSQL pg_stat_activity。只有这些证据在同一时间线上能够相互解释,才能把“连接复用有效”从配置假设提升为运行事实。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

验证连接复用效果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通