pgbouncer

管理数据库连接池。

概要

  1. pgbouncer [OPTION ...] pgbouncer.ini
  2. OPTION
  3. [ -d | --daemon ]
  4. [ -R | --restart ]
  5. [ -q | --quiet ]
  6. [ -v | --verbose ]
  7. [ {-u | --user}=username ]
  8. pgbouncer [ -V | --version ] | [ -h | --help ]

描述

PgBouncer是Greenplum和PostgreSQL数据库的轻量级连接池管理器。 gBouncer为每个数据库用户和数据库组合创建一个池。PgBouncer或者为客户端创建一个新的数据库连接, 或者重用一个现有的连接。当客户端断开连接时,连接被返回到池中以供重用。

PgBouncer支持PostgreSQL和Greenplum数据库共享的标准连接接口。 Greenplum数据库客户端程序(例如psql)可以连接到PgBouncer 正在运行的主机和端口号,而不是直接连接Greenplum数据库的主机或端口号。

可以通过配置文件声明PgBouncer和他的Greenplum数据库访问。提供的配置文件名 通常为pgbouncer.ini,供pgbouncer 命令使用。该配置文件还能提供Greenplum数据库位置信息。pgbouncer.ini 配置文件也定义了线程数、连接池、授权用户和授权配置信息,另外还有一些其他信息。

默认情况下,pgbouncer作为一个前端进程运行。可以通过 启动pgbouncer时指定-d选项来让其 在后台执行。

pgbouncer进程被操作系统用户拥有。在启动pgbouncer 时可以指定一个不同的用户名。

PgBouncer包括一个类似psql的管理控制台。 授权用户可以连接到虚拟数据库来监控和管理PgBouncer。也可以通过管理控制台来监控和管理后台进程。 也可以使用控制台更新和重载PgBouncer配置文件,此时不需要通知或重启该进程。

有关PgBouncer的更多信息,请参考 PgBouncer FAQ

选项

-d | —daemon

运行PgBouncer作为守护进程(后台进程)。默认是作为前台进程运行。

作为守护进程启动时,PgBouncer显示启动消息到stdout。 要禁止显示消息,请添加-q选项。

要关闭PgBouncer守护程序,请登录管理控制台并发出SHUTDOWN命令。

-R | —restart

使用指定的命令行参数重新启动PgBouncer。在重新启动期间,维护与数据库的非TLS连接,TLS连接被丢弃。

要作为守护程序重新启动PgBouncer,请指定选项-Rd。

Note: 仅在操作系统支持Unix套接字且PgBouncer配置没有 unix_socket_dir的情况下有效。

-q | —quiet

安静地运行,不在命令行(stdout)上显示消息。

-v | —verbose

增加消息详细度。显示额外的消息。可以多次使用。

{-u | —user}=username

PgBouncer进程假定的username的身份。

-V | —version

显示版本并退出。

-h | —help

显示帮助信息并退出。

另见

pgbouncer.inipgbouncer-admin