PgBouncer 技术文档

1. 安装指南

依赖项

PgBouncer 的编译依赖于以下软件包：

• GNU Make 3.81+
• Libevent 2.0+
• pkg-config
• OpenSSL 1.0.1+（用于 TLS 支持）
• 可选：c-ares（作为 Libevent 的 evdns 替代）
• 可选：PAM 库

安装步骤

1. 确保所有依赖项已安装。
2. 下载 PgBouncer 源代码。
3. 运行以下命令进行编译和安装：

   $ ./configure --prefix=/usr/local
   $ make
   $ make install
   

从 Git 构建

如果从 Git 构建，需要额外步骤：

1. 克隆仓库并初始化子模块：

   $ git clone https://github.com/pgbouncer/pgbouncer.git
   $ cd pgbouncer
   $ git submodule init
   $ git submodule update
   

2. 生成配置文件并编译：

   $ ./autogen.sh
   $ ./configure
   $ make
   $ make install
   

Windows 构建

在 Windows 上，仅支持使用 MinGW 构建：

1. 运行以下命令：

   $ ./configure
   $ make
   

2. 如果从 Unix 交叉编译，使用：

   $ ./configure --host=i586-mingw32msvc
   

2. 项目使用说明

启动 PgBouncer

在 Unix 系统上，可以使用以下命令启动 PgBouncer：

$ pgbouncer -d config.ini

在 Windows 上，可以使用以下命令注册为服务：

$ pgbouncer -regservice config.ini

配置文件

PgBouncer 的配置文件通常为 pgbouncer.ini，包含连接池、用户认证等设置。

日志记录

在 Windows 上，可以通过设置 syslog = 1 并注册 pgbevent.dll 来使用 Windows 事件日志。

3. 项目 API 使用文档

连接池管理

PgBouncer 提供了轻量级的 PostgreSQL 连接池管理功能，支持多种连接池模式，如会话池、事务池和语句池。

用户认证

PgBouncer 支持多种认证方式，包括 PAM 认证。通过 ./configure --with-pam 启用 PAM 支持后，可以使用 pam 认证类型。

DNS 查询

PgBouncer 支持异步 DNS 查询，默认使用 c-ares，也可以使用 Libevent 的 evdns 或 libc 的 getaddrinfo。

4. 项目安装方式

Unix 系统

1. 安装依赖项。
2. 运行 ./configure、make 和 make install 进行编译和安装。

Windows 系统

1. 使用 MinGW 进行编译。
2. 运行 ./configure 和 make。
3. 注册为 Windows 服务。

通过以上步骤，您可以成功安装并使用 PgBouncer 进行 PostgreSQL 连接池管理。