pgbouncer - 云端在线

程序：

您的姓名

pgbouncer - PostgreSQL 的轻量级连接池

概要

pgbouncer [-d][-R][-v][-u 用户]
pgbouncer -V|-h

在 Windows 计算机上，选项是：

pgbouncer.exe [-v][-u 用户]
pgbouncer.exe -V|-h

设置 Windows 服务的其他选项：

pgbouncer.exe --regservice
pgbouncer.exe --unregservice

商品描述

弹跳器 是一个 PostgreSQL 连接池。 任何目标应用程序都可以连接到
弹跳器 好像它是一个 PostgreSQL 服务器，并且 弹跳器 将创建与
实际服务器，否则它将重用其现有连接之一。

的宗旨， 弹跳器 是为了降低打开新连接对性能的影响
PostgreSQL。

为了不损害连接池的事务语义， 弹跳器
旋转连接时支持多种类型的池：

时间 池
最礼貌的方法。 当客户端连接时，服务器连接将分配给
它在整个持续时间内客户端保持连接。 当客户端断开连接时，
服务器连接将被放回池中。 这是默认方法。

交易 池
服务器连接仅在事务期间分配给客户端。 什么时候
PgBouncer 通知事务结束，服务器连接将被放回
进入游泳池。

个人陈述 池
最激进的方法。 服务器连接将被放回池中
查询完成后立即。 不允许多语句事务
这种模式因为他们会打破。

的管理界面 弹跳器 由一些新的 SHOW 可用命令
当连接到特殊的“虚拟”数据库时 弹跳器.

快速开始

基本设置和使用如下。

1. 创建一个 pgbouncer.ini 文件。 详情在 弹跳器(5). 简单的例子：

[数据库]
模板 1 = 主机 = 127.0.0.1 端口 = 5432 数据库名称 = 模板 1

[保镖]
监听端口 = 6543
听地址 = 127.0.0.1
验证类型 = md5
auth_file = 用户.txt
日志文件 = pgbouncer.log
pidfile = pgbouncer.pid
admin_users = 某个用户

2。 创建 用户.txt 包含允许的用户的文件：

"someuser" "same_password_as_in_server"

3。 发射 弹跳器:

$ pgbouncer -d pgbouncer.ini

4. 将您的申请（或 psql的 客户端）连接到 弹跳器 而不是直接到
PostgreSQL 服务器：

$ psql -p 6543 -U 某些用户模板1

5.管理 弹跳器 通过连接到特殊管理数据库 弹跳器 和
发行 显示 救命; 开始：

$ psql -p 6543 -U someuser pgbouncer
pgbouncer=# 显示帮助；
注意：控制台使用
详情：
显示 [帮助|配置|数据库|FDS|池|客户端|服务器|插座|列表|版本]
SET 键 = arg
RELOAD
暂停
暂停
简历
关断

6. 如果您对 pgbouncer.ini 文件进行了更改，您可以使用以下命令重新加载它：

pgbouncer=# 重新加载；

指挥 LINE 开关类

-d 在后台运行。 没有它，进程将在前台运行。 注意：不
在 Windows 上工作， 弹跳器 需要在那里作为服务运行。

-R 进行在线重启。 这意味着连接到正在运行的进程，加载
从中打开套接字，然后使用它们。 如果没有活动进程，则启动
一般。 注意：仅当操作系统支持 Unix 套接字并且 unix_socket_dir is
未在配置中禁用。 不适用于 Windows 机器。 不适用于 TLS
连接，它们被丢弃。

-u 用户
启动时切换到给定用户。

-v 增加冗长。 可以多次使用。

-q 保持安静 - 不要登录到标准输出。 请注意，这不会影响日志记录的详细程度，只会影响
不使用标准输出。 用于 init.d 脚本。

-V 显示版本。

-h 显示简短的帮助。

--注册服务
Win32：注册 pgbouncer 作为 Windows 服务运行。 这 服务名称 配置
参数值用作名称来注册。

--取消注册服务
Win32：注销 Windows 服务。

ADMIN CONSOLE

控制台可以通过正常连接到数据库来使用 弹跳器:

$ psql -p 6543 弹跳器

仅配置参数中列出的用户 管理员用户 or 统计用户 被允许去（做
登录控制台。 （除了当 auth_mode=任何，那么任何用户都可以作为
stats_user。）

此外，用户名 弹跳器 允许无密码登录，如果登录
来自 Unix 套接字，并且客户端具有与正在运行的进程相同的 Unix 用户 uid。

展示 命令
这款 SHOW 命令输出信息。 每个命令描述如下。

SHOW 统计数据；
显示统计信息。

数据库
统计数据按数据库显示。

总请求数
汇集的 SQL 请求总数 弹跳器.

收到的总数
接收的网络流量的总字节数 弹跳器.

总发送
发送的网络流量的总字节数 弹跳器.

总查询时间
花费的微秒总数 弹跳器 当主动连接到
PostgreSQL。

平均请求
上一统计期间每秒的平均请求数。

平均接收
每秒平均接收（从客户端）字节。

平均发送
每秒平均发送（到客户端）字节。

平均查询
以微秒为单位的平均查询持续时间。

SHOW 服务器；
类型 S，为服务器。

用户 用户名 弹跳器 用于连接服务器。

数据库
数据库名称。

州 pgbouncer 服务器连接的状态，其中之一 要积极。, 用过的 or 闲置.

地址 PostgreSQL 服务器的 IP 地址。

端口 PostgreSQL 服务器的端口。

本地地址
本地机器上的连接起始地址。

本地端口
本地机器上的连接启动端口。

连接时间
建立连接时。

请求时间
发出最后一个请求的时间。

PTR 此连接的内部对象的地址。 用作唯一 ID。

链接 服务器配对的客户端连接地址。

远程进程号
后端服务器进程的pid。 如果通过 unix socket 和 OS 进行连接
支持获取进程 ID 信息，它是操作系统 pid。 否则它是从
取消发送的数据包服务器，如果服务器是 Postgres，它应该是 PID，但它是
一个随机数，以防它为另一个 PgBouncer 服务。

SHOW 客户；
类型 C、为客户。

用户 客户端连接用户。

数据库
数据库名称。

州 客户端连接的状态，其中之一 要积极。, 用过的, 等候 or 闲置.

地址 客户端的 IP 地址。

端口 客户端连接到的端口。

本地地址
本地机器上的连接结束地址。

本地端口
本地机器上的连接结束端口。

连接时间
连接时间的时间戳。

请求时间
最新客户端请求的时间戳。

PTR 此连接的内部对象的地址。 用作唯一 ID。

链接 客户端配对的服务器连接地址。

远程进程号
进程 ID，以防客户端通过 UNIX 套接字连接并且操作系统支持获取它。

SHOW 池；
为每对（数据库、用户）创建一个新的池条目。

数据库
数据库名称。

用户 用户名。

cl_active
链接到服务器连接并可以处理查询的客户端连接。

cl_等待
客户端连接已发送查询但尚未获得服务器连接。

sv_活动
链接到客户端的服务器连接。

sv_空闲
未使用且可立即用于客户端查询的服务器连接。

sv_已使用
空闲时间超过 服务器检查延迟，所以他们需要
服务器检查查询 在它可以使用之前运行它。

sv_测试
当前正在运行的服务器连接 服务器重置查询 or
服务器检查查询.

登录
当前正在登录过程中的服务器连接。

最大等待
队列中第一个（最旧的）客户端等待的时间，以秒为单位。 如果这开始
增加，那么当前的服务器池处理请求的速度不够快。
原因可能是服务器过载或太小 池大小 设置。

池模式
正在使用的池化模式。

SHOW 列表；
在列（不是行）中显示以下内部信息：

数据库
数据库的数量。

用户 用户数。

池 池数。

免费客户端
免费客户的数量。

使用过的客户
使用的客户端计数。

登录客户端
客户数量 登录 州。

免费服务器
免费服务器的数量。

使用过的服务器
使用的服务器计数。

SHOW 用户；
姓名 用户名

池模式
用户的覆盖 pool_mode，如果将使用默认值，则为 NULL。

SHOW 数据库；
姓名 配置的数据库条目的名称。

主持人 主机 pgbouncer 连接到。

端口 端口 pgbouncer 连接到。

数据库
pgbouncer 连接到的实际数据库名称。

强制用户
当用户是连接字符串的一部分时，pgbouncer 和
PostgreSQL 被强制给给定的用户，无论客户端用户是什么。

池大小
服务器连接的最大数量。

池模式
数据库的覆盖 pool_mode，如果将使用默认值，则为 NULL。

SHOW FDS；
内部命令 - 显示正在使用的 fd 列表，并附有内部状态。

当连接的用户具有用户名“pgbouncer”时，通过 Unix 套接字连接并具有
与正在运行的进程相同的 UID，实际的 fds 通过连接传递。 这个
机制用于进行在线重启。 注意：这不适用于 Windows 机器。

此命令还阻止内部事件循环，因此不应在 PgBouncer 处于运行状态时使用它
正在使用。

fd 文件描述符数值。

任务 其中一个 池子, 客户 or 服务器.

用户 使用 FD 连接的用户。

数据库
使用 FD 的连接数据库。

地址 使用 FD 的连接的 IP 地址， UNIX 如果使用 unix 套接字。

端口 使用 FD 的连接所使用的端口。

取消 此连接的取消键。

链接 fd 对应的服务器/客户端。 如果空闲，则为 NULL。

SHOW 配置;
显示当前配置设置，每行一个，包含以下列：

键 配置变量名

折扣值 配置值

多变
或 含 or 没有, 显示是否可以在运行时更改变量。 如果 没有，
变量只能在启动时更改。

SHOW DNS_HOSTS；
在 DNS 缓存中显示主机名。

主机
主机名。

TTL 距离下一次查找还有多少秒。

地址 逗号分隔的地址列表。

SHOW DNS_ZONES
在缓存中显示 DNS 区域。

区域名称
区域名称。

串行 当前连续剧。

数 属于该区域的主机名。

流程 控制 命令
暂停 [D b];
PgBouncer 尝试与所有服务器断开连接，首先等待所有查询完成。
在所有查询完成之前，该命令不会返回。 在使用的时候
数据库重启。

如果给出了数据库名称，则只会暂停该数据库。

禁用 D b;
拒绝给定数据库上的所有新客户端连接。

ENABLE D b;
允许新的客户端连接之前 禁用 命令。

KILL D b;
立即删除给定数据库上的所有客户端和服务器连接。

挂起;
所有套接字缓冲区都被刷新并且 PgBouncer 停止监听它们上的数据。 这
命令不会在所有缓冲区都为空之前返回。 在 PgBouncer 时使用
在线重启。

简历 [D b];
恢复以前的工作 暂停 or 暂停 命令。

关掉;
PgBouncer 进程将退出。

重新加载；
PgBouncer 进程将重新加载其配置文件并更新可更改的设置。

信号
签到 重新加载配置。 与发出命令相同 重新加载； 在控制台上。

SIGINT 安全关机。 与发行相同 暂停; 和 关掉; 在控制台上。

目标期限
立即关机。 与发行相同 关掉; 在控制台上。

自由事件 设置
来自 libevent 文档：

可以禁用对 epoll、kqueue、devpoll、poll 的支持
或者通过设置环境变量EVENT_NOEPOLL来选择，
EVENT_NOKQUEUE、EVENT_NODEVPOLL、EVENT_NOPOLL 或 EVENT_NOSELECT，
。

通过设置环境变量EVENT_SHOW_METHOD，libevent
显示它使用的内核通知方法。

使用 onworks.net 服务在线使用 pgbouncer