Pgbouncer 管理员手册

From PgsqlWiki

 pgbouncer(5)

名称

pgbouncer - PostgreSQL 的轻量连接池。

 摘要

[databases] db = ...

[pgbouncer] ...

 描述

配置文件是 "ini" 格式的。段名称是在 " 和 " 之间的。以 ; 或者 ‘"’开头的行被当作注释并被忽略。在非行首的位置出现的“;”和‘"’都不会被识别。

 [pgbouncer]段

 常用设置

 logfile

声明日志文件。日志文件是保持打开状态的，直到 kill -HUP 或者在控制台上 RELOAD; 完成之后。

缺省：没设置。

 pidfile

声明 pid 文件。没有 pidfile 就不允许成为守护进程。

缺省：没有设置。

 listen_addr

声明一个用于监听 TCP 连接的 IPv4 地址。或者 * 就是意味着“监听所有地址”。如果不设置，那么只允许 unix socket 连接。

缺省：没有设置

 listen_port

监听哪个端口。适用于 TCP 和 UNIX socket。

缺省：6000

 unix_socket_dir

声明 Unix socket 的位置。适用于监听 socket 和服务器连接。如果设置为空串，那么会关闭 Unix socket。

缺省：/tmp

 auth_file

从此文件中装载用户名和口令。使用的文件格式和 PostgreSQL 的 pg_auth/pg_pwd 文件一样，所以可以直接指向后端的文件。

缺省：未设置。

auth_type

如何认证用户。

md5

使用 MD5 为基础的口令检查。auth_file 可以包含 md5 加密或者明文的密码。缺省值。

crypt

使用 crypt(3) 为基础的口令检查。auth_file 必须包含明文密码。

plain

在线上发送的是明文密码。

trust

不做认证。用户名必须仍然在 auth_file 中存在。

any

类似 trust，但是给出的用户名被忽略。要求所有数据库配置成以特定用户登录。

 pool_mode

声明何时服务器连接会被标记为被其他客户端重用的。

session

在客户端断开之后，服务器释放回连接池。缺省。

transaction

服务器在事务完成之后释放回连接池。

statement

在查询结束之后，服务器就释放回连接池。在这种模式下不允许跨越多个语句的长事务。