[转]PostgreSQL数据库连接池Pgbouncer的搭建

作者：何伟平
来源：http://www.pgsqldb.org/mwiki/index.php/Pgbouncer%E6%90%AD%E5%BB%BA%E6%95%B0%E6%8D%AE%E5%BA%93%E8%BF%9E%E6%8E%A5%E6%B1%A0

最近有些项目我们是采用PostgreSQL进行后端数据库，由于要对客户端的连接使用类型和连接数进行控制，因此我们采用PgBouncer来进行实施。

PgBouncer相关的基本文档pgsqldb中文站已经有不少文档，这里我就不再作过多的说明，我将集中对其中的几个要点和我实践中遇到的问题和大家分享一下。

OK，肺话也不多少，开始正题吧;D

gBouncer介绍

• 什么是PgBouncer?

PgBouncer是一个轻量级的数据库连接池。download

• PgBouncer的作用

1. PgBouncer可以在后端数据库和前端应用间建立连接的桥梁，由PgBouncer去处理和后端数据库的连接关系。
2. 对客户端连接进行限制，预防过多或者恶意的连接请求。

• PgBouncer的特点

1. 内存消耗低(默认为2k/连接)，因为Bouncer不需要每次都接受完整的数据包
2. 可以把不同的数据库连接到一个机器上，而对客户端保持透明
3. 支持在线的重新配置而无须重启
4. 仅支持V3协议，因此后端版本须>=7.4

开始使用PgBouncer

• 基本ini文件配置（假设我们创建了新的ini文件/usr/local/pgsql/conf/pgbouncer.ini）

1. 添加目标数据库的连接字符串，这个表示PgBouncer将会在哪些后端数据库中建立连接，比如：

template1 = host=127.0.0.1 port=5432 dbname=template1

2. 设定PgBouncer的监听端口, port=5555，默认为6000

3. 创建用户列表文件并添加用户信息，此用户为允许客户端使用的连接用户名，比如：

A. zhaoyi@zhaoyi-laptop:[~]$ echo "user" "password" > /usr/local/pgsql/user.txt
B. 在ini设定：auth_file = /usr/local/pgsql/user.txt

4. 创建admin用户，在配置中添加：admin_users = user，用户可以使用此用户名连接pgbouncer并查看运行状况等，注意：此用户必须为user.txt文件中已经存在的用户。

• 启动并测试连接/查看运行状况

1. 启动:pgbouncer -d pgbouncer.ini

2. 测试连接：psql -h 127.0.0.1 -p 6000 -U user template1

3. 通过admin用户连接pgbouncer查看配置：

psql -h 127.0.0.1 -p 6000 -U user pgbouncer
pgbouncer=# show config;

3. 通过admin用户连接pgbouncer查看运行情况：

pgbouncer=# show stats;
pgbouncer=# show lists; 
pgbouncer=# show pools;
pgbouncer=# show databases;
#其余运行参数可以通过如下命令查看
pgbouncer=# show help;

4. 参数修改：如果修改了ini文件中相关参数，需要通过命令告知bouncer重新读取配置内容：

pgbouncer=# reload;

PgBouncer连接类型

1. 会话池连接：即以一个session为生命期，当客户端断开的时候，才断开并释放连接回连接池
2. 事务连接：服务器连接只是在一个事务的过程里赋予客户端的
3. 语句连接：在每个查询结束之后，服务器的连接都会立即放回连接池。在这种模式下将不允许多语句的事务。否则，会给出如下提示，比如

test=# begin;
 ERROR:  Long transactions not allowed
   server closed the connection unexpectedly
   This probably means the server terminated abnormally
   before or while processing the request.
 The connection to the server was lost. Attempting reset: Succeeded.

客户端连接方式

这里我简单说明一下客户端不同连接方式时服务器端的处理方式，以perl中为例：

$dbh = DBI -> connect('dbi:Pg:dbname=test;host=127.0.0.1;port=6000', 'postgres', ' ' ) or die $DBI::errstr;

1. 客户端为AutoCommit时，transaction类型 = statements类型
2. pool类型为transaction类型，如果客户端不为AutoCommit时，必须显示Commit，否则连接不释放
3. pool类型为statements类型时，连接不支持长语句，因此客户端必须AutoCommit，否则依然会报错

AutoCommit配置为：

{'AutoCommit' => 0}

连接参数配置及客户端状态

• max_client_conn

1. 这个为允许客户端连接的最大数目
2. 你可以通过show clients进行查看，当客户段连接大于此设置时，客户端会得到类似如下信息：

 psql: ERROR:  no more connections allowed

• default_pool_size

1. 这个为当前连接池中允许的最大处理连接
2. 比如default_pool_size=3，如果在连接池没有空余连接的情况下，如果已经连接的客户端尝试通过PgBouncer向后端执行查询请求，则客户端会一直处理等待状态，当有空余的连接释放时，比如其他的客户端断开连接时，PgBouncer才会把此请求放如连接池中，向后端提出服务请求，后端收到请求后，才执行请求返回结果，比如

 template1=# select * from test;
 --no result

以上测试都是基于 pgbouncer version 1.1.1 + psql (PostgreSQL) 8.3.3

相关文档

• Config file documentation
• Usage document
• 用户手册
• 管理员手册

<!-- Saved in parser cache with key pgwiki:pcache:idhash:473-0!1!0!!zh-cn!2 and timestamp 20081103160112 -->

相关参考：
http://pgfoundry.org/projects/pgbouncer/

<!-- end content -->