特性

PgBouncer 特性——池化模式与 SQL 兼容性

原始页面: https://www.pgbouncer.org/features.html

  • 连接轮换时,按激进程度分为以下几种策略:

    会话池化
    最温和的方式。当客户端连接时,将为其分配一个服务端连接,并在客户端保持连接期间始终持有。当客户端断开时,服务端连接将放回连接池。此模式支持所有 PostgreSQL 特性。
    事务池化
    仅在事务期间为客户端分配服务端连接。当 PgBouncer 检测到事务结束时,服务端连接将放回连接池。此模式会破坏 PostgreSQL 的部分会话级特性,只有在应用程序配合、不使用不兼容特性的情况下才可使用。不兼容特性详见下表。
    语句池化
    最激进的方式。这是事务池化的变体:禁止多语句事务。这是为了在客户端强制执行“自动提交”(autocommit)模式,主要面向 PL/Proxy。
  • 内存占用极低(默认每连接仅需 2 kB)。这是因为 PgBouncer 无需一次性看到完整的数据包。

  • 不绑定到单一后端服务器。目标数据库可以分布在不同的主机上。

  • 支持大多数配置项的在线重新配置。

  • 支持在不断开客户端连接的情况下在线重启/升级。


各池化模式的 SQL 特性兼容表

下表列出了 PostgreSQL 的各项特性及其与 PgBouncer 池化模式的兼容性。请注意,事务池化在设计上就会打破客户端对服务端的预期,只有在应用程序配合、不使用不可用特性的情况下方可使用。

特性会话池化事务池化
Startup parameters 1
SET/RESET不支持
LISTEN不支持
NOTIFY
WITHOUT HOLD CURSOR
WITH HOLD CURSOR不支持
Protocol-level prepared plans2
PREPARE / DEALLOCATE不支持
ON COMMIT DROP temp tables
PRESERVE/DELETE ROWS temp tables不支持
Cached plan reset
LOAD statement不支持
Session-level advisory locks不支持

  1. 启动参数包括:client_encodingDateStyleIntervalStyleTimezonestandard_conforming_stringsapplication_name。PgBouncer 会检测这些参数的变化,从而确保客户端获得一致的值。如果需要 PgBouncer 支持更多启动参数,请参阅 track_extra_parametersignore_startup_parameters。 ↩︎

  2. 需要将 max_prepared_statements 设置为非零值以启用此支持。 ↩︎