数据库连接池是一种数据库连接的缓存。一旦一个池子的连接被建立，连接池就能消除创建数据库连接的开销，这样客户端能更快地连接并且服务器的负载也能被降低。

PgBouncer连接池来自于PostgreSQL社区，它被包括在Greenplum数据库中。PgBouncer可以为多个数据库管理连接池，并且这些数据库可以位于不同的Greenplum数据库集群或者PostgreSQL后端。PgBouncer会为每一种数据库用户与数据库的组合建立一个池。一个被池化的连接只能被来自于同一个用户和数据库的另一个连接请求重用。

客户端应用不需要做软件修改，但是要连接到连接池的主机和端口而不是Greenplum的Master主机和端口。PgBouncer会创建新的数据库连接或者重用一个已有的连接。当客户端断开连接时，该连接会被返回给连接池以备重用。

PgBouncer支持PostgreSQL和Greenplum数据库所共享的标准连接接口。一个请求数据库连接的客户端会提供PgBouncer所在的主机名及端口，还有数据库名、用户名和口令。PgBouncer在其配置文件中查找所请求的数据库（可能是真实数据库的一个别名）为数据库连接找到主机名、端口和数据库名。配置文件条目还决定如何认证用户以及将使用哪个数据库角色，一个“强制用户”可以覆盖客户端连接请求所提供的用户名。

PgBouncer要求一个认证文件，它是一个包含了用户和口令列表的文本文件。口令可能是明文、被MD5编码过或者一个LDAP/AD查找串。用户也可以设置PgBouncer为不在认证文件中的用户查询目标数据库。

可以为PgBouncer设置一种默认的池模式，并且该模式可以被单个数据库和用户覆盖。

通过连接到一个虚拟的pgbouncer数据库，用户可以使用类SQL命令监控和管理PgBouncer。可以不重启PgBouncer就修改配置参数，只需要重新载入配置文件就能发现更改。

PgBouncer还不支持SSL连接。如果用户想要加密客户端和PgBouncer之间的通信，用户可以使用stunnel，它是一种使用OpenSSL加密库创建TLS加密隧道的免费软件工具。方法请见用stunnel保护PgBouncer。

PgBouncer可以被运行在Greenplum数据库的Master上或者另一台服务器上。如果用户把PgBouncer安装在一台单独的服务器上，用户可以通过更新PgBouncer配置文件并且用PgBouncer管理控制台重载该配置来轻易地把客户端切换到后备Master上。

设置PgBouncer的步骤如下。

1. 创建一个PgBouncer配置文件，例如pgbouncer.ini。 这里是一个简单的配置文件：

   [databases]
   postgres = host=127.0.0.1 port=5432 dbname=postgres
   mydb = host=127.0.0.1 port=5432 dbname=mydb
   
   [pgbouncer]
   pool_mode = session
   listen_port = 6543
   listen_addr = 127.0.0.1
   auth_type = md5
   auth_file = users.txt
   logfile = pgbouncer.log
   pidfile = pgbouncer.pid
   admin_users = gpadmin

   该文件是.ini文件格式并且有三个小节： databases、pgbouncer和users。databases小节列出了数据库及其连接细节。pgbouncer小节配置了PgBouncer实例。

2. 创建一个认证文件。该文件的名称必须匹配pgbouncer.ini文件中的 auth_file参数，在这个例子中是 users.txt。每一行包含一个用户名和口令。口令串的格式匹配PgBouncer配置文件中的auth_type参数。如果auth_type参数是plain，口令串就是一个明文口令，例如：

   "gpadmin" "gpadmin1234"

   下面例子中的auth_type是md5，因此认证域必须被MD5编码。被MD5编码的口令格式是：

   "md5" + MD5(<password><username>)

   用户可以使用Linux的md5sum命令来计算MD5串。例如，如果gpadmin的口令是admin1234，下面的命令会打印用于口令域的字符串：

   $ user=gpadmin; passwd=admin1234; echo -n md5; echo $passwd$user | md5sum
   md53ce96652dedd8226c498e09ae2d26220

   这里是PgBouncer认证文件中用于gpadmin用户的MD5编码过的条目：

   "gpadmin" "md53ce96652dedd8226c498e09ae2d26220"

   要用LDAP或者活动目录服务器认证用户，口令域应该包含一个LDAP查找串。例如：

   "gpdbuser1" "ldap://10.0.0.11:10389/uid=gpdbuser1,ou=users,ou=system"

   对于活动目录，一个用户条目看起来像这个例子：

   "gpdbuser2" "ldap://10.0.0.12:389/gpdbuser2"

   配置PgBouncer用LDAP服务器认证用户的步骤请见对PgBouncer设置LDAP认证。

   关于认证文件的细节，请见Greenplum数据库工具指南中PgBouncer参考的“认证文件格式”小节。

3. 启动 pgbouncer:

   $ $GPHOME/bin/pgbouncer -d pgbouncer.ini

   -d or --daemon选项会让PgBouncer作为一个后台进程运行。pgbouncer命令的语法及其选项请见Greenplum数据库工具指南中的PgBouncer参考。

4. 更新客户端应用，让它们连接到pgbouncer而不是直接连接到Greenplum数据库服务器。要启动psql，例如：

   $ psql -p 6543 -U someuser postgres

当一个连接被返回给连接池时，它必须被重置为刚创建的连接的状态。在把一个连接返回给连接池之前，PgBouncer通过发出一个查询来实现这种重置。PostgreSQL 8.3及其后的版本有一个用于此种目的的DISCARD ALL命令，它标准PgBouncer发布的默认重置查询。Greenplum数据库不支持DISCARD ALL，如果使用该命令会出现错误。

RESET ALL; SET SESSION AUTHORIZATION DEFAULT

这是Greenplum数据库 4.7.0及其后版本包括的PgBouncer修改版中的默认服务器重置查询。尽管它与PgBouncer原生的不同，它也能确保连接池对于Greenplum数据库用户透明并且客户端应用不需要为了使用连接池而被修改。

更多有关PgBouncer配置文件的server_reset_query参数的信息，请见Greenplum数据库工具指南中的PgBouncer参考。

PgBouncer有一个管理控制台，可以登录到pgbouncer虚拟数据库来访问它。该控制台接受类SQL命令，这些命令允许用户监控、重新配置和管理PgBouncer。

要开始使用PgBouncer管理控制台，请遵循下列步骤。

1. 用 psql登录到pgbouncer虚拟数据库：

   $ psql -p 6543 -U username pgbouncer

   用户名必须是pgbouncer.ini配置文件中admin_users参数中所设置的值。如果pgbouncer进程运行在用户登录的当前Unix用户的UID下，用户还可以用该用户名登录。

2. 要看可用的命令，可运行show help命令：

   pgbouncer=# show help;
   NOTICE:  Console usage
   DETAIL:
          SHOW HELP|CONFIG|DATABASES|POOLS|CLIENTS|SERVERS|VERSION
   	SHOW STATS|FDS|SOCKETS|ACTIVE_SOCKETS|LISTS|MEM
   	SHOW DNS_HOSTS|DNS_ZONES
   	SET key = arg
   	RELOAD
   	PAUSE [<db>]
   	RESUME [<db>]
   	DISABLE <db>
   	ENABLE <db>
   	KILL <db>
   	SUSPEND
   	SHUTDOWN

3. 如果用户对pgbouncer.ini文件做了修改，用户可以用 RELOAD命令重载它：

   pgbouncer=# RELOAD;

所有管理控制台命令的完整文档，请见Greenplum数据库工具指南中PgBouncer参考的“PgBouncer管理控制台命令”。

用户可以在不丢掉连接的情况下升级PgBouncer。只需要用-R选项和相同的配置文件启动一个新的PgBouncer进程：

$ pgbouncer -R -d config.ini

-R（重启）选项导致这个新进程通过一个Unix套接字连接到旧进程的控制台并且发出下列命令：

SUSPEND;
SHOW FDS;
SHUTDOWN;

当新进程看到旧进程已经消失，它会使用旧的连接继续工作。这是可能的，因为SHOW FDS命令会把真实的文件描述符发送给新进程。如果这种传送由于任何原因失败，可杀死新进程让旧进程继续。

在使用PgBouncer连接池时，用户可以用LDAP或者活动目录服务来认证Greenplum数据库用户。在使用LDAP认证时，用户可以通过设置stunnel来保护客户端连接（见用stunnel保护PgBouncer连接。

PgBouncer没有SSL支持，因此数据库客户端和PgBouncer之间的连接是没有被加密的。要加密这些连接，用户可以使用stunnel，它是一种免费软件工具。stunnel是一种使用OpenSSL加密库把TLS加密加到网络服务的代理。较新版本的stunnel支持PostgreSQL的libpq协议，因此Greenplum和PostgreSQL客户端可以使用libpq的SSL支持安全地通过网络连接到作为PgBouncer代理设置的stunnel实例。如果用户使用的stunnel版本没有libpq支持，用户需要在客户端和PgBouncer主机两端都设置一个stunnel实例，这样才能在网络上创建一个安全的隧道。

在大部分平台上，用户都可以用系统的包管理器安装stunnel。对于Windows，用户可以从 https://www.stunnel.org/index.html下载一个安装器。如果没有打包好的版本可用，或者想要升级到新的版本，或者想要升级到一个新的OpenSSL版本，用户也可以下载源代码来安装stunnel。下一节提供了下载、编译和安装OpenSSL及stunnel的步骤。

完整的stunnel文档请访问stunnel documentation网站。