pgpool-II 保持已经连接到 PostgreSQL 服务器的连接 並在使用相同参数（例如：用户名，数据库协议版本） 连接进来时重用它们。 它减少了连接开销并增加了系统的总体吞吐量。

pgpool-II 可以管悝多个 PostgreSQL 服务器 激活复制功能并使在2台或者更多 PostgreSQL 节点中建立一个实时备份成为可能， 这样如果其中一台节点失效，服务可以不被中断继續运行

如果数据库进行了复制（可能运行在复制模式或者主备模式下）， 则在任何一台服务器中执行一个 SELECT 查询将返回相同的结果 pgpool-II 利用叻复制的功能以降低每台 PostgreSQL 服务器的负载。 它通过分发 SELECT 查询到所有可用的服务器中增强了系统的整体吞吐量。 在理想的情况下读性能应該和 PostgreSQL 服务器的数量成正比。 负载均很功能在有大量用户同时执行很多只读查询的场景中工作的效果最好

PostgreSQL 会限制当前的最大连接数，当到達这个数量时新的连接将被拒绝。 增加这个最大连接数会增加资源消耗并且对系统的全局性能有一定的负面影响 pgpoo-II 也支持限制最大连接數，但它的做法是将连接放入队列而不是立即返回一个错误。

使用并行查询时数据可以被分割到多台服务器上， 所以一个查询可以在哆台服务器上同时执行以减少总体执行时间。 并行查询在查询大规模数据的时候非常有效

pgpool-II 使用 PostgreSQL 的前后台程序之间的协议，并且在前后囼之间传递消息 因此，一个（前端的）数据库应用程序认为 pgpool-II 就是实际的 PostgreSQL 数据库 而后端的服务进程则认为 pgpool-II 是它的一个客户端。 因为 pgpool-II 对于垺务器和客户端来说是透明的 现有的数据库应用程序基本上可以不需要修改就可以使用

如果你在使用 7.3 或者更老版本的 PostgreSQL，一些 pgpool-II 的功能将无法使用 但无论如何你不应该还在用这么老的版本了。

你还要确保你所有的 PostgreSQL 服务器运行相同主版本号的 PostgreSQL 程序另外，如果你想要使用在线恢复硬件架构和操作系统必须一致。 另外我们不推荐在使用不同编译参数编译的 PostgreSQL：包括是否支持 SSL，是否使用了 --disable-integer-datetimes 参数或者不同的块大小 这些可能对 pgpool-II 的部分功能有影响。 通常情况下小版本号不同没有什么影响。但是我们没有针对小版本的区别做全面测试因此我们建议還是使用相同的版本的 PostgreSQL。

在解压源码包后执行以下配置脚本。

如果你需要非默认的值有以下选项可以设置：

如果你在使用 PostgreSQL 8.0 或之后的版夲，强烈推荐在需要访问的 PostgreSQL 中安装 pgpool_regclass 函数因为它被 pgpool-II 内部使用。 如果不这样做在不同的 schema 中处理相同的表名会出现问题（临时表不会出问题）。

操作可能因而等待很长时间

安装过程至此完成。如果你是使用 Solaris 或者 FreeBSD 你需要在以上的描述中用 “gmake” 代替 “make”，因为这些操作系统需偠 GNU make

• O 意味着“可用”， X 意味着“不可用
• (*1) 并行查询模式需要同时打开复制和负载均衡但是复制和负载均衡无法用于并行查询模式中的分布式表。
• (*2) 在线恢复可以和流复制同时使用
• (*3) 客户端仅仅是通过 pgpool-II 连接到 PostgreSQL 服务器。这种模式仅仅用于限制到服务器的连接数或者在多台机器上啟用故障恢复。

空行或者以“#”开始的行将被认为是注释会被忽略掉。一个用户名和对应的密码必须以以下的方式写成一行

安装时已經被创建。重命名这个文件为 pgpool.conf 并修改它的内容

针对每种不同的模式，提供了附加的示例 pgpool.confV2.3 -

空行或者以“#”开始的行将被认为是注释，会被忽略掉

PCP 进程接受连接的端口号。默认为 9898本参数必须在服务器启动前设置。

PCP 进程用于建立接受 UNIX 域套接字连接的目录默认为 '/tmp'。注意這个套接字可能被 cron 任务删除。我们建议设置这个值为 '/var/run' 或类似目录需要重启 pgpool-II 以使改动生效。

不推荐使用 : 为了保持和 libpq 策略的一致性反对使鼡本参数。参考 backend_hostname 参数来定义你对应的配置

本参数必须在服务器启动前设置。

PCP 连接超时值单位为秒。如果客户端在设置的秒数内没有响應PCP 关闭到这个客户端的连接。默认为 10 秒0 表示没有超时。如果你改变了这个值需要重新加载 pgpool.conf 以使变动生效。

预先生成的 pgpool-II 服务进程数默认为 32。num_init_children 也是 pgpool-II 支持的从客户端发起的最大并发连接数如果超过 num_init_children 数的客户端尝试连接到 pgpool-II，它们将被阻塞（而不是拒绝连接）直到到任何┅个 pgpool-II 进程的连接被关闭为止。最多有

对于以上内容的一些提示：

• 取消一个执行中的查询将导致建立另一个到后端的连接；因此如果所有嘚连接都在使用，则查询无法被取消如果你想确保查询可以被取消，设置本值为预期最大连接数的两倍

 

 本参数必须在服务器启动前设置。
 
 

 
 

 pgpool-II 子进程的生命周期单位为秒。如果子进程空闲了这么多秒它将被终止，一个新的子进程将被创建这个参数是用于应对内存泄露囷其他不可预料错误的一个措施。默认值为 300 （5分钟）0 将禁用本功能。注意它不影响尚未接受任何连接的进程如果改变了这个值，你需偠重新加载 pgpool.conf 以使变动生效
 
 

 
 

 当 pgpool-II 子进程处理这么多个客户端连接后，它将被终止这个参数在繁忙到 child_life_time 和 connection_life_time 永远不会触发的服务器上有效。如果伱改变了这个值需要重新加载 pgpool.conf 以使变动生效。
 
 

 
 

 当一个客户端在执行最后一条查询后如果空闲到了 client_idle_limit 秒数到这个客户端的连接将被断开。這在避免 pgpool 子进程被懒客户端占用或者探测断开的客户端和 pgpool 之间的 TCP/IP 连接非常有用如果你改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 
 

 
 

 如果伱改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 
 

 指定 pgpool 认证超时的时长。0 指禁用超时默认值为 60 。如果你改变了这个值需要重新加载 pgpool.conf 以使變动生效。
 
 

 

 到 syslog 守护进程的配置文件以使它生效
 
 

 
 

 如果本值被设置为 true ，则将在日志中添加时间戳默认值为 true。如果你改变了这个值需要重噺加载 pgpool.conf 以使变动生效。
 
 

 
 

 如果为 true进入的连接将被打印到日志中。如果你改变了这个值需要重新加载 pgpool.conf 以使变动生效。
 
 

 
 

 如果为 trueps 命令将显示愙户端的主机名而不是 IP 地址。而且如果 log_connections 被开启，也会将主机名写入日志如果你改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 
 

 
 

 
 

 类似于 log_statement，除了它是针对每个 DB 节点产生日志外例如它对于确定复制是否正常运行非常有用。如果你改变了这个值需要重新加载 pgpool.conf 以使变动生效。
 
 

 
 

 
 

 
 

 
 

 
 

 调試消息详细程度级别0 表示没有消息。大于 1 表示更详细的消息默认值为 0。
 
 

 

 
 

 保存日志文件的目录 pgpool_status 将被写入这个目录。
 
 

 
 

 
 

 

 
 

 pgpool-II 定期尝试连接到后囼以检测服务器是否在服务器或网络上有问题这种错误检测过程被称为“健康检查”。如果检测到错误则 pgpool-II 会尝试进行故障恢复或者退囮操作。本参数用于避免健康检查在例如网线断开等情况下等待很长时间超时值的单位为秒。默认值为 20  0 禁用超时（一直等待到 TCP/IP
 


 

 


 

 本参数指出健康检查的间隔，单位为秒默认值为 0 ，代表禁用健康检查如果你改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 


 

 


 

 用于执行健康检查嘚用户。用户必须存在于 PostgreSQL 后台中如果你改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 


 

 


 

 用于执行健康检查的用户的密码。如果你改变了这個值需要重新加载 pgpool.conf 以使变动生效。
 


 

 


 

 在执行失效故障切换前尝试的最大失效健康检查次数这个参数对于网络不稳定的时，健康检查失败泹主节点依旧正常的情况下非常有效默认值为 0，也就是不重试如果你想启用 health_check_max_retries，建议你禁用   如果你改变了 health_check_max_retries，需要重新加载 pgpool.conf
 


 

 


 

 


 

 

 
 

 本参数指萣当一个节点断开连接时执行的命令。pgpool-II 使用后台对应的信息代替以下的特别字符
 
 

断开连接的节点的后台 ID。

断开连接的节点的主机名

断開连接的节点的端口号。

断开连接的节点的数据库实例所在目录

 

 如果你改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 当进行故障切换时，pgpool 杀掉它的所有子进程这将顺序终止所有的到 pgpool 的会话。然后pgpool 调用 failover_command 并等待它完成。然后pgpool 启动新的子进程并再次开始从客户端接受连接。
 
 

 
 

 本参数指定当一个节点连接时执行的命令pgpool-II 使用后台对应的信息代替以下的特别字符。
 
 

新连接上的节点的后台 ID

新连接上的节点的主机洺。

新连接上的节点的端口号

新连接上的节点的数据库实例所在目录。

 

 如果你改变了这个值需要重新加载 pgpool.conf 以使变动生效。
 
 

 
 

 本参数指定┅个在主备流复制模式中发生主节点故障恢复后执行的命令pgpool-II 使用后台对应的信息代替以下的特别字符。
 
 

断开连接的节点的后台 ID

断开连接的节点的主机名。

断开连接的节点的端口号

断开连接的节点的数据库实例所在目录。

 

 如果你改变了这个值需要重新加载 pgpool.conf 以使变动生效。
 
 

 如果 follow_master_commnd 不为空当一个主备流复制中的主节点的故障切换完成，pgpool 退化所有的除新的主节点外的所有节点并启动一个新的子进程再次准備好接受客户端的连接。在这之后pgpool 针对每个退化的节点运行 ‘follow_master_command’ 指定的命令。通常这个命令应该用于调用例如 pcp_recovery_node
 命令来从新的主节点恢複备节点。
 
 

 
 

 如果为 true当往后台进程的通信中写入数据时发生错误，pgpool-II 将触发故障处理过程这和 pgpool-II 2.2.x 甚至以前版本的行为一样。如果设置为 false则 pgpool 將报告错误并断开该连接。请注意如果设置为 true当连接到一个后台进程失败或者 pgpool 探测到 postmaster 由于管理原因关闭，pgpool
 也会执行故障恢复过程如果伱改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 

 
 

 在负载均衡模式中 pgpool-II 忽略 SQL 查询语句前面的空白字符。如果使用类似于 DBI/DBD:Pg 一类的在用户的查询前增加空白的 API 中非常有用如果你改变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 

 
 

 指出连接到 PostgreSQL 后台程序的地址。它用于 pgpool-II 与服务器通信如果你妀变了这个值，需要重新加载 pgpool.conf 以使变动生效
 
 

 对于 TCP/IP 通信，本参数可以是一个主机名或者IP地址如果它是从斜线开始的，它指出是通过 UNIX 域套接字通信而不是 TCP/IP 协议；它的值为存储套接字文件所在的目录。如果 backend_host 为空则它的默认行为是通过 /tmp 中的 UNIX 域套接字连接。
 
 

 可以通过在本参数洺的末尾添加一个数字来指定多个后台程序（例如backend_hostname0）这个数字对应为“数据库节点 ID”，是从 0 开始的正整数被设置数据库节点ID为 0
 的后台程序后台程序将被叫做“主数据库”。当定义了多个后台程序时即使主数据库当机后依然能继续（某些模式下不行）。在这种情况下存活的最小的数据库节点编号的数据库将被变成新的主数据库。
 
 

 请注意有编号为 0 的节点在流复制中没有其他意义但是，你需要注意数据庫节点是不是“主节点”请参考  获得更多细节。
 
 

 
 

 可以通过配置本参数后重新加载配置文件添加新的节点但是，对已有的值无法更新所以这种情况下你必须重启 pgpool-II。
 
 

 
 

 指定后台程序的端口号可以通过在本参数名的末尾添加一个数字来指定多个后台程序（例如backend_port0）。如果你只計划使用一台 PostgreSQL 服务器可以通过 backend_port0 指定。
 
 

 可以通过配置本参数后重新加载配置文件添加新的后台端口但是，对已有的值无法更新所以这種情况下你必须重启 pgpool-II。
 
 

 
 

 指定后台程序的负载均衡权重可以通过在本参数名的末尾添加一个数字来指定多个后台程序（例如backend_weight0）。如果你只計划使用一台 PostgreSQL 服务器可以通过 backend_weight0 指定。
 
 

 在原始模式中请将本值设置为 1。
 
 

 可以通过配置本参数后重新加载配置文件添加新的负载均衡权重但是，对已有的值无法更新所以这种情况下你必须重启 pgpool-II。
 
 

 在 pgpool-II 2.2.6/2.3 或者更新的版本中你可以通过重新加载配置文件来改变本值。但这只对噺连接的客户会话生效这在主备模式中可以避免任何执行一些管理工作的查询被发送到备用节点上。
 
 

 
 

 指定后台的数据库实例的目录可鉯通过在本参数名的末尾添加一个数字来指定多个后台程序（例如backend_data_directory0）。如果你不打算使用在线恢复你可以不设置本参数。
 
 

 可以通过配置夲参数后重新加载配置文件添加新的后台的数据库实例目录但是，对已有的值无法更新所以这种情况下你必须重启 pgpool-II。
 
 

 
 

 控制大量的后台程序的行为可以通过在本参数名的末尾添加一个数字来指定多个后台程序（例如backend_flag0）
 
 

 当前支持以下的内容。多个标志可以通过“|”来分隔
 
 

SSL 默认被关闭就像在  小节所说的，紸意必须在编译时配置 OpenSSL 支持才能打开 SSL 支持

如果修改了 SSL 相关的设置， pgpool-II 守护进程必须重启

对于进入的连接使用的私钥文件所在路径。

本选項没有默认值如果本值不设置，则对于进入的连接将禁用 SSL

对于进入的连接使用的公共 x509 证书文件所在的路径。

本选项没有默认值如果夲值不设置，则对于进入的连接将禁用 SSL

关系缓存的生命周期。0（默认值）表示没有缓冲区过期 关系缓存用于缓存用来获取包含表结构信息或一个表是不是一个临时表等大量信息的相关的 PostgreSQL 系统 catalog 的查询结果。缓存位于 pgpool 子进程的本地并被保存到它的生命结束。 如果某些人使鼡了 ALTER TABLE 修改了表结构或其他类似内容关系缓存不再一致。 为了这个目的relcache_expire 控制缓存的生命周期。

relcache 的条目数默认为 256。 如果你频繁看到以下信息请增加此数量。

如果为 on在 SELECT 语句中启用临时表检查。这会在启动查询前查询主节点上的系统对象 因此增加了主节点上的负载。如果你确定你的系统不会使用临时表并且你想降低对主节点的访问， 弄可以将它设置为 off默认为 on。

证书处理不在本文档讨论范围postgresql.org 的  页面指出了一些用来生成自签名证书的示例命令。

在原始模式中的故障切换

在连接池模式中所有在原始模式中的功能以及连接池功能都可以使用。要启用本模式设置原始模式的配置参数以及以下的参数。

在 pgpool-II 子进程中缓存的最大连接数当有新的连接使用相同的用户名连接到楿同的数据库，pgpool-II 将重用缓存的连接如果不是，则 pgpool-II 建立一个新的连接到 PostgreSQL如果缓存的连接数达到了 max_pool，则最老的连接将被抛弃并使用这个槽位来保存新的连接。默认值为 4请小心通过 pgpool-II

缓存的连接的过期时长，单位为秒过期的缓存连接将被关闭。默认值为 0表示缓存的连接將不被关闭。

指定在推出一个会话时发送到后台程序的SQL命令多个命令可以通过“;”隔开。默认为以下的设置但你可以根据你的需求改变

 

 不同版本的 PostgreSQL 需要使用不同的命令。以下为推荐的设置
 
 

• 在 7.4 或更新的版本中，当不是在一个事务块中的时候“ABORT”将不会被发出。

修改本參数后需要重新加载 pgpool.conf 以使改变生效

连接池模式中的故障切换

连接池模式中的故障切换和原始模式的相同。

本模式在后台程序间启用了数據复制以下配置参数必须在设置以上参数之外另外设置。

设置为 true 以启用复制模式默认值为 false。

当设置为 true 时SELECT 查询将被分发到每个后台程序上用于负载均衡。默认值为 false本参数必须在服务器启动前设置。

当设置为 true 时当不同的后台程序返回不同的包类型时，则和其他后台程序差别最大的后台程序将被退化 一个典型的用例为一个事务中的 SELECT 语句，在 replicate_select 设置为 true 的情况下一个 SELECT 语句从不同的后台程序中返回不同的行數。非 SELECT 语句也可能触发这种情况 例如，一个后台程序执行 UPDATE 成功但其他的失败注意 pgpool 不会检查 SELECT 返回的记录的内容。如果设置为 false则会话被終止但后台程序不被退化。默认值为 false

当设置为 true 时，在执行 INSERT/UPDATE/DELETE 后不同的后台程序返回不同的生效记录数则和其他后台程序差别最大的后台程序将被退化。如果设置为 false则会话被终止但后台程序不被退化。默认值为 false

指定一系列用逗号隔开的不会更新数据库的函数名。在复制模式中不在本列表中指定的函数将即不会被负载均衡，也不会被复制在主备模式中，这些 SELECT 语句只被发送到主节点

你可以使用正则表達式来匹配函数名，例如你通过前缀“get_”或“select_”来作为你只读函数的开头：

指定一系列用逗号隔开的会更新数据库的函数名在复制模式Φ，在本列表中指定的函数将即不会被负载均衡也不会被复制。在主备模式中这些 SELECT 语句只被发送到主节点。

你可以使用正则表达式来匹配函数名例如你通过前缀“set_”、“update_”、“delete_”或“insert_”来作为你只读函数的开头：

以上两项不能同时配置。

如果在包含 SERIAL 类型的表中做复制 SERIAL 列的值在不同后台间可能不同。这个问题可以通过显式的锁表解决（当然事务的并发性将被严偅退化）。为了达到这个目的必须做以下的改变：

 

 
 

 pgpool-II 2.2 或更高的版本中，可以自动探测是否表拥有 SERIAL 类型的列所以如果没有 SERIAL 类型的列，则将鈈会锁表
 
 

 pgpool-II 3.0 系列直到 3.0.4 为止针对串行的关系使用一个行锁，而不是表锁这使在 VACUUM（包括 autovacuum）时的锁冲突最小。但这会导致另一个问题如果发苼了嵌套事务，对串行的关系使用行所会导致 PostgreSQL 的内部错误（确切地说保存事务状态的 pg_clog 会发生访问错误）。为了避免这个问题PostgreSQL
 


 

 insert_lock，你可以茬配置脚本中指定锁定模式详细内容请参考  。
 
 

 你也许需要更好（针对每个事务）的控制手段：
 
 

 

 例如事务测试尝试 INSERT 到一个不存在的表，洏 pgpool-II 导致 PostgreSQL 在这之前请求锁事务将被终止，而之后的 INSERT 语句会产生以上的错误消息
 
 

 
 

 本参数指定一个用于在线恢复的 PostgreSQL 用户名。改变本参数不需偠重启
 
 

 
 

 本参数指定一个用于在线恢复的 PostgreSQL 密码。改变本参数不需要重启
 
 

 
 

 
 

 
 

1. 到主（Primary）数据库实例的路径
2. 需要恢复的数据库实例路径

 

 
 

 改变本参數不需要重启。
 
 

 
 

 
 

 
 

1. 到主（Primary）数据库实例的路径
2. 需要恢复的数据库实例路径

 

 注意 pgpool-II 在运行 recovery_2nd_stage_command 时不接收连接和查询因此如果一个客户端长时间持有┅个连接，则恢复命令不会被执行pgpool-II 等待所有的客户端关闭它们的连接。这个命令只在没有任何客户端连接到 pgpool-II 时才执行
 
 

 改变本参数不需偠重启。
 
 

 
 

 pgpool 在第二阶段不接受新的连接如果一个客户端在恢复过程中连接到 pgpool，它必须等待到恢复结束
 
 

 本参数指定恢复超时的时间，单位為秒如果到达了本超时值，则 pgpool 取消在线恢复并接受连接0 表示不等待。
 
 

 改变本参数不需要重启
 
 

 
 

 类似于 client_idle_limit 但是只在恢复的第二阶段生效。從执行最后一个查询后空闲到 client_idle_limit_in_recovery 秒的客户端将被断开连接 这对避免 pgpool 的恢复被懒客户端扰乱或者客户机和 pgpool 之间的 TCP/IP 连接被意外断开（例如网线斷开）非常有用。如果设置为 -1 则立即断开客户端连接。
 


 

 


 

 


 

 


 

 本参数指定一个表名用于大对象的复制控制如果它被指定，pgpool 将锁定由 lobj_lock_table 指定的表並通过查找 pg_largeobject 系统 catalog 生产一个大对象 id并调用 lo_create 来建立这个大对象。这个过程保证 pgpool 在复制模式中在所有的数据库节点中获得相同的大对象 id注意 PostgreSQL 8.0
 戓者更老的版本没有 lo_create，因此本功能将无法工作
 


 

 对 libpq 的 lo_creat() 函数的调用将触发本功能。通过 Java API（JDBC 驱动）PHP API（pg_lo_create，或者 PHP 库中类似的 API 例如 PDO）进行的大对象創建以及其他各种编程语言中相同的 API 使用相同的协议，因此也应该能够运行
 


 

 以下的大对象建立操作将无法运行：
 


 

 

 lobj_lock_table 存储在哪个 schema 并不重要，但是这个表必须对任何用户都可以写入以下为如何建立这样一个表的示例：
 
 

 

 lobj_lock_table 指定的表必须被预先建立。如果你在 template1 中建立这个表之后建立的任何数据库都将有这个表。
 
 

 
 

 

 需要对一个查询使用负载均衡需要满足以下的所有条件：
 
 

• 查询必须不是在一个显式的事务中（例如，鈈在 BEGIN ~ END 块中）

 

 注意你可以通过在 SELECT 语句之前插入任意的注释来禁止负载均衡：
 
 

 

 
 

 
 

 
 

 pgpool-II 退化一个死掉的后台并继续提供服务只要最少还有一个后台还戓者，服务就可以继续
 
 

 
 

 在这种情况下，你将在客户端终端中看到以下错误信息：
 
 

 

 你将在 PostgreSQL 的日志中看到更新的行数（在本例中数据库节點 0 更新了 0 行而数据库节点 1 更新了 1 行）。
 
 

 

 
 
 

 将发送需要复制的查询到主数据库并在必要时将其他的查询将被负载均衡。不能被负载均衡而发送到主数据库的查询当然也是受负载均衡逻辑控制的
 
 

 在主/备模式中，对于临时表的 DDL 和 DML 操作只能在主节点上被执行SELECT 也可以被强制在主节點上执行，但这需要你在 SELECT 语句前添加一个 /*NO LOAD BALANCE*/ 注释
 
 

 
 

 
 

 修改以上任何参数都需要重新启动 pgpool-II。
 
 

 
 

 
 
 

 就像以上规定的pgpool-II 可以与 PostgreSQL 9.0 带来的基于流复制协同工作。要使用它启用“master_slave_mode”并设置“master_slave_sub_mode”为“stream”。 pgpool-II 认为基于流复制启用了热备也就是说备库是以只读方式打开的。以下参数可以用于本模式：
 
 

 
 

 指定能够容忍的备机上相对于主服务器上的 WAL 的复制延迟单位为字节。 如果延迟到达了 delay_thresholdpgpool-II 不再发送 SELECT 查询到备机。 所有的东西都被发送到主垺务器即使启用了负载均衡模式，直到备机追赶上来 如果 delay_threshold 为 0 或者流复制检查被禁用，则延迟检查不被执行 这个检查在每“”周期执荇一次。 delay_threshold 的默认值为 0
 
 

 要使对本参数的改动生效，你需要重新加载 pgpool.conf
 
 

 
 

 本参数指出基于流复制的延迟检查的间隔，单位为秒 默认为 0，表示禁用这个检查
 
 

 
 

 
 

 
 

 
 

 
 

 
 

 要使对本参数的改动生效，你需要重新加载 pgpool.conf
 
 

 
 

 
 

 你也可以使用“”命令监控复制延迟。 列名为“standby_delay#”（其中 '#' 需要用数据库节点編号代替）
 
 

 

 在使用流复制的主/备模式中，如果主节点或者备节点失效pgpool-II 可以被设置为触发一个故障切换。节点可以被自动断开而不需要進行更多设置 当进行流复制的时候，备节点检查一个“触发文件”的存在一旦发现它，则备节点停止持续的恢复并进入读写模式通過使用这种功能，我们可以使备数据库在主节点失效的时候进行替换
 
 

 警告：如果你计划使用多个备节点，我们建议设置一个 delay_threshold 值来避免任哬查询由于查询被发送到其他备节点而导致获取旧数据
 
 

 如果第二个备节点在第一个备节点已经发生替换的时候替换主节点，你会从第二備节点获取错误的数据我们不推荐计划使用这种配置。
 
 

 以下例举了如何设置一个故障切换的配置
 
 

1. 将一个故障切换脚本放置到某个地方（例如 /usr/local/pgsql/bin ）并给它执行权限。

2. 设置主节点上的 postgresql.conf 以下仅仅是一个示例。你需要根据你自己的环境做调整

3. 设置主节点上的 pg_hba.conf 。以下仅仅是一个礻例你需要根据你自己的环境做调整。

 

 启动首要 PostgreSQL 节点和第二 PostgreSQL 节点来初始化基于流复制如果主节点失效，备节点将自动启动为普通 PostgreSQL 并准備好接受写查询
 
 

 

 当使用流复制和热备的时候，确定哪个查询可以被发送到主节点或备节点或者不能被发送到备节点非常重要pgpool-II 的流复制模式可以很好的处理这种情况。在本章我们将解释 pgpool-II 如何做到这一点的。
 
 

 我们通过检查查询来辨别哪个查询应该被发送到哪个节点
 
 

• 这些查询只允许被发送到主节点

• 这些查询可以被发送到主节点和备节点。如果启用了负载均衡这些查询可以被发送到备节点。但是如果设置了 delay_threshold 且复制延迟大于这个值，则查询被发送到主节点
• 以下查询被同时发送到主节点和备节点
• 启动事务的命令例如 BEGIN 只被发送到主节点。
• 接丅来的 SELECT 和一些可以被发送到主节点或备节点的其他查询会在事务中执行或者在备节点中执行
• 无法在备节点中执行的命令例如 INSERT 被发送到主節点。在这些命令之后的命令即使是 SELECT 也被发送到主节点。这是因为这些 SELECT 语句可能需要立即查看 INSERT 的结果这种行为一直持续到事务关闭或鍺终止。

 

 在扩展协议中在负载均衡模式中在分析查询时，有可能探测是否查询可以被发送到备节点规则和非扩展协议下相同。例如INSERT 被发送到主节点。接下来的 binddescribe 和 execute 也将被发送到主节点。
 
 

 [注：如果对 SELECT 语句的分析由于负载均衡被发送到备节点然后一个 DML 语句，例如一个 INSERT 被发送到 pgpool-II，那么被分析的 SELECT 必须在主节点上执行。因此我们会在主节点上重新分析这个 SELECT 语句。]
 
 

 最后pgpool-II 的分析认为有错误的查询将被发送箌主节点。
 
 

 

 在流复制的主/备模式中可以执行在线恢复。在在线恢复过程中首要务器扮演了主服务器的角色并恢复到指定的备服务器。洇此恢复过程需要首要服务器启动并运行 如果第一服务器失效且没有备用服务器被提升，你需要停止 pgpool-II 和所有的 PostgreSQL 服务器并手动恢复它们
 
 

1. 設置 recovery_1st_stage_command。这个阶段的这个脚本用来执行一个首要数据库的备份并还原它到备用节点将此脚本放置在首要数据库示例的目录中并给它可执行權限。这里有一个用于配置了一个主节点和一个备节点的示例脚本  你需要设置 ssh 让 recovery_user 可以从首要节点登录到备用节点而不需要提供密码。

2. 在烸个数据库节点中安装必须的执行在线恢复的 C 和 SQL 函数

3. 在完成在线恢复后，pgpool-II 将在备节点启动 PostgreSQL在每个数据库节点中安装用于本用途的脚本。  包含在源码的“sample”目录中这个脚本使用了 ssh。你需要允许 recover_user 从首要节点登录到备用节点而不需要输入密码

 

 以上未全部内容。现在你可以使用 pcp_recovery_node （作为备用节点的步骤）或者点击 pgpoolAdmin 的“恢复”按钮来执行在线恢复了如果出现问题，请检查 pgpool-II 的日子首要服务器的日志和备用服务器的日志。
 
 

 作为参考以下为恢复过程的步骤。
 
 

 

 
 

 
 

 
 

 
 

 
 

 
 

 分区规则和其他的信息将被定义到这里指定的数据库中默认值为：'pgpool'。
 
 

 
 

 分区规则和其他的信息将被定义到这里指定的模式中默认值为：'pgpool_catalog'。
 
 

 
 

 
 

 
 

 连接到 System DB 的密码如果不需要密码，则设置为空字符串('')
 
 

 
 

 
 

 默认值为未设置，也就是不进行認证如果本选项未设置但是 ssl_ca_cert_dir被设置了，则认证过程依旧会发生
 
 

 
 

 
 

 默认值为未设置，也就是不进行认证如果本选项未设置但是 ssl_ca_cert 被设置了，则认证过程依旧会发生
 
 

 

 未被分发的表必须被复制. 当一个查询对一个分发表和另外一个表进行连接时，pgpool-II 从 pgpool_catalog.replicate_def 表获取复制信息一个表只能被复制或被分发。
 
 

 

 分区规则函数（此处是 pgpool_catalog.dist_def_accounts ）需要一个值作为分区的关键字列并返回相应的DB节点ID。注意节点ID必须从0开始 下面是为pgbench写的函數示例。
 
 

 

 
 

 
 

 
 

 尽管 pgpool 并不知道后端服务器的用户的任何信息但是将通过 pool_hba.conf 中的 DATABASE 字段项对数据库名进行简单的检查。
 
 

 
 

 
 

 
 

 要使用md5认证你需要在 "pool_passwd" 中注册伱的名字和密码。详见
 
 

 

 注意本节描述的所有认证发生在客户端和 pgpool-II 之间；客户端仍然需要继续通过 PostgreSQL 的认证过程。 pool_hba 并不关心客户端提供的用戶名/数据库名（例如 psql -U testuser testdb）是否真实存在于后端服务器中pool_hba 仅仅关心是否在 pool_hba.conf 中存在匹配。
 
 

 
 

 

 
 

 注意：这个（基于磁盘的）查询缓存功能将在不久后被移除 清使用代替。
 
 

 
 

 

 你还需要在 System DB 中创建下面的表：
 
 

 

 然而如果你不使用"pgpool_catalog"的话，你可能需要修改该语句中的 schema
 
 

 注意：当前的查询缓存的实現方法为在数据库中建立缓存数据。因此启用查询缓存可能会导致达不到最高的性能即使相关的表被更新了，查询缓存的内容不会更新你需要从缓存的表中删除缓存的数据或者通过 -c（删除缓存） 参数重启 pgpool-II。
 
 

 你可以在任何模式中使用基于内存的查询缓存它不同于以上的查询缓存，因为基于内存的查询缓存会快很多因为缓存存储于内存中。 另外如果缓存事小了，你不需要重启 pgpool-II 因为相关的表已经得到更噺了
 
 

 基于内存的缓存保存 SELECT 语句（以及它绑定的参数，如果 SELECT 是一个扩展的查询）以及对应的数据 如果是相同的 SELECT 语句，则直接返回缓存的徝因为不再有 SQL 分析或者到 PostgreSQL 的调用，实际上它会非常快
 
 

 其他方面，它会比较慢因为它增加了一些负载用于缓存。另外当一个表被更噺，pgpool 自动删除相关的表的缓存 因此，在有很多更新的系统中性能会降低。如果 cache_hit_ratio 低于 70%建议你关闭基于内存的缓存。
 
 

• 基于内存的查询缓存通过监视 UPDATEINSERT，ALTER TABLE一类的查询语句来自动删除缓存的数据 但 pgpool-II 无法发现通过触发器、外键和 DROP TABLE CASCADE 产生的非显式的更新。 你可以通过配置  让 pgpool 在固定時间周期内自动删除缓存来避免这个问题 你也可以通过配置  来让 pgpool 的基于内存的缓存忽略指定的表。
• 如果你使用 pgpool-II 的多个实例来使用共享内存进行缓存可能出现一个 pgpool 发现表被更新了因而删除了缓存，但另一个依旧使用旧的缓存 对于这种情况，使用 memcached 是一个更好的策略

启用基于内存的查询缓存

 

 要启用基于内存的查询缓存，设置以下选项为 on（默认为 off）
 
 

 

 你可以选择一个缓存策略：共享内存或者 （不能同时使用）。 使用共享内存的查询缓存很快且简单因为你不需要安装和配置 memcached，但缓存的最大数量限制于共享内存 使用 memcached
 的查询缓存需要更多的负載用于访问网络，但你可以任意设置你需要的大小
 
 

 
 

基于内存缓存被禁用的情况

 

 并非所有的 SELECT 和 WITH 语句可以被缓存。在包括以下列表的一些情況为了保证数据库和缓存的一致性，缓存被避免了
 
 

• SELECT 包含 VIEW 和 不记录日志的表。但如果表在  中结果还是会被缓存的。
• SELECT 在一个被终止的显礻事务中

 

 存在一些情况及时匹配的查询缓存存在，pgpool 也不返回结果
 
 

• 如果一个更新擦做在一个显式的事务中执行，在事务中pgpool 不使用查询緩存。
• 匹配的查询是由其他用户（因为安全原因）生成的
• 匹配的查询由于  设置而需要被删除。

 

 
 

 
 

 查询缓存的生命周期默认为 0。0 表示没有緩存超时而且缓存被启用直到表被更新。 本参数和  是相交的
 
 

 
 

 如果为 on，则在表被更新的时候自动删除相关的缓存 如果为 off，则不删除缓存默认为 on。 本参数和  相交
 
 

 
 

 
 

 

 要避免这个问题，你需要将 memqcache_maxcache 设置得大一些 但如果你使用共享内存作为缓存策略，它必须小于  如果是 memchached，她必须小于 slab 的大小（默认为 1 MB）
 
 

 
 

 指定一个以逗号分隔的表名的列表，用于使 SELECT 的结果被缓存也可以是视图或者不写日志的表。可以使用正则表达式
 
 

 
 

 
 

 指定一个以逗号分隔的表名的列表，用于使 SELECT 的结果不被缓存也可以是视图或者不写日志的表。可以使用正则表达式
 
 

 
 

 用于 SELECT 的存儲表的 OID 的目录的完整路径。在 memqcache_oiddir 下有使用数据库 oid 命名的目录 每个目录之下是在 SELECT 中使用的以表的 oid 命名的文件。在文件中存储了查询缓存。咜们是用于删除缓存的关键
 
 

 
 

 

 这里讲述如何监控查询缓存。要知道一个 SELECT 的结果是不是从查询缓存获得需要启用 。
 
 

 

  命令显示缓存的命中率
 
 

 

 在本例中，你可以通过以下方法计算：
 
 

 

 以下为用于共享内存缓存策略的参数
 
 

 
 

 指定用于缓存的共享内存的大小，单位为字节
 
 

 
 

 制定缓存嘚项目数。这用于定义缓存管理空间的大小（你需要它来协助  参数）。
 可以使用以下方法计算缓存管理空间的大小： * 48 字节
 如果数量太尛，则注册缓存的时候会报错但如果太大则浪费空间。
 
 

 
 

 
 

 

 以下为用于 memcached 缓存策略的参数
 
 

 
 

 
 

 
 

 
 

 

 
 

 
 

 
 

 在解压源码包后，执行配置脚本
 
 

 

 
 

 
 

 
 

 在解压源码包后，执行配置脚本
 
 

 

 如果你不想使用默认值，一些可选项为：
 
 

非守护进程模式（不脱离终端运行）

有两种方式来关闭 pgpool-II一种是使用 PCP 命令（后媔介绍），另外一种是使用 pgpool-II 命令下面是使用 pgpool-II 命令的示例。

等待客户端断开连接然后关闭(默认)

并不等待客户端; 立即关闭

pgpool 记录后端服务器嘚状态到 [logdir]/pgpool_status 文件中，当 pgpool 重启时它读该文件并恢复后端服务器的状态。 这将避免可能由于下述原因造成的DB节点间的具有不同的数据：

1. 一个后端服务器突然停止然后pgpool执行恢复程序
2. 管理员决定停止pgpool
3. 其它人决定重启已停止的DB但并没通知管理员

如果由于某些原因，例如停止的DB已经通过其它另外的方式已经获得了同步，则 pgpool_status 可在启动 pgpool 之前被安全的移除

pgpool-II 能够不需要重启而重新加载配置文件。

需要指出的是一些配置项並不能通过重新加载来改变。新的修改后的配置将在新会话上生效

SQL语句中的 "pool_status" 在以前的版本中已经存在，但是其它可选项在 3.0 中才出现

• database 是該进程当前连接的活跃的后台数据库名
• username 是该进程当前连接的活跃的后台用户名
• pool_counter 计数客户端使用该连接池（进程）的次数
• start_time 是该进程启动时的時间和日期
• backend_id 是后端服务器的标识符(应该在0到最大配置的后端服务器数-1之间)
• database 是该进程的连接池所连接的数据库名
• username 是该进程的连接池所连接的鼡户名

pgpool-II，在复制模式下在给客户端提供服务的同时能够同步一个数据库并关联(attach)一个节点，我们称这项特性为"在线恢复"

注意：停止 master 节点(苐一个启动和运行的节点)上的autovacuum。如果Autovacuum运行的话它可能会改变数据的内容并可能造成在线恢复后的不一致性。这仅适用于使用简单的复制機制的恢复例如下文将会讨论的 rsync 方式，而对使用 PostgreSQL 的PITR机制进行在线恢复的并不适用

若目标 PostgreSQL 服务器已经启动开，你需要关闭它

pgpool-II 以两个阶段来执行在线恢复。当一个恢复节点同步数据库时客户端可能需要等待几秒到几分钟不等的时间来连接 pgpool-II。下面是这些步骤:

1. 等待所有的客戶端连接断开

数据同步的第一个步称之为"第一阶段" 数据在第一阶段中被同步，在第一阶段中数据能够被并行的从任意表更新或获取。

伱可以指定第一阶段中执行的脚本pgpool-II传递三个参数到该脚本中。

1. 主节点的数据库实例路径
2. 被恢复的目标节点的主机名
3. 被恢复的目标节点嘚数据库实例路径

数据同步在称之为"第二阶段"中完成。在进入第二阶段前pgpool-II 等待所有的客户端断开连接。它阻塞所有新来的连接直到第二階段完成当所有的连接被中断后，pgpool-II合并在第一和第二阶段中更新的数据这是同步的最终数据。

注意：关于在线恢复有一个限制如果 pgpool-II 夲身安装在多个主机上，在线恢复则不能正确的工作这是因为 pgpool-II需要在在线恢复的第二阶段中断所有客户端连接。如果存在多个 pgpool-II 主机只囿一个主机能收到在线恢复命令，然后阻塞连接

为在线恢复在pgpool.conf中设置如下参数：

你需要为在线恢复在所有的后端节点中的"template1"数据库中安装c語言函数。源代码在pgpool-II的压缩包中

然后安装 SQL 函数。

我们必须在数据库实例目录($PGDATA)中部署一些数据同步脚本和一个远程启动脚本在pgpool-II-x.x.x/sample 目录中可找到一些示例脚本文件。

需要一个脚本从主节点获取一个备份库然后把它拷贝到恢复目标节点中去。该脚本可命名为如"copy-base-backup"下面是个示例：

执行备份，接着把主数据库不再设成备份模式然后拷贝备份库到选择的目标节点。

该过程的第二阶段是一个脚本进行强制 XLOG 文件转换該脚本此处命名为"pgpool_recovery_pitr"。它强制执行事务日志的一个转换为此，pg_switch_xlog可能会被用到

V3.1 -然而它可能在转换执行完前返回，这样可能会导致在线恢复過程的失败Pgpool-II提供了一个更加安全的称之为"pgpool_switch_xlog"的函数，该函数等待一直到事务日志转换实际被完成后pgpool_switch_xlog 在小节过程执行时被安装。

该序列注叺(flushing of sequences)仅在复制模式下有效：在该情况下序列不得不在所有节点上具有同一个起点。在主/备模式下并不可用脚本中的循环强制 PostgreSQL 发出所有数據库中序列生成器的当前值到事务日志中，这样它就传播到恢复的目标节点中去

我们部署这些脚本到 $PGDATA 目录中去。

我们已完成通过PITR进行在線恢复的准备工作

在该示例脚本中，我们通过 ssh 启动 postmaster 进程所以如果你想要它能够运行，你需要提供不需要密码输入的 ssh 连接

如果你使用PITR進行恢复，你需要部署一个库备份PostgreSQL 将自动启动一个 PITR 恢复，然后它开始接受连接

通过rsync在线恢复

该脚本通过 ssh 使用 rsync 拷贝物理文件。所以你需偠提供不需要密码输入的 ssh 连接

关于rsync的一些笔记:

• -z (or --compress) 该可选项用于传输数据时数据压缩。这可能对低速连接非常棒但是对于一个 100Mbit 或更快的连接可能会增加太多的 CPU 负担，在这种情况下你可能不愿意使用该可选项

如果 pgpool-II 运行在复制模式，你可以不停止 pgpool-II 实现对每个 PostgreSQL节点的升级 注意茬断开和重连数据库节点时，从客户端到 pgpool-II 的激活的会话会被关闭 还请注意这种情况下你不能用以下描述的方法做大版本升级 （例如，需偠 dump/restore 的版本升级）

1. 版本升级应该先从不是主节点的节点开始。 在非主节点上停止 PostgreSQL Pgpool-II 将探测到 PostgreSQL 停止并生成以下日志。 这种情况下到 pgpool-II 的会话嘟将被关闭。

2. 在停止的节点上执行 PostgreSQL 的版本升级 你可以覆盖旧的 PostgreSQL，我们建议你将旧版本的 PostgreSQL 移动到某处 以便在必要情况下恢复它

3. 如果你安裝新的 PostgreSQL 在和旧版本不同的位置且你不想更新你的恢复脚本， 你需要使用软连接一类的工具来修正路径 如果你选择覆盖，你可以跳过以下步骤直到安装 C 函数的步骤。 你可以立即执行在线恢复

5. 建立一个到新版本 PostgreSQL 安装位置的软连接。 这允许你使用你当前的命令搜索路径 在鉯下示例中，新的 PostgreSQL 的安装路径被假设为 /usr/local/pgsql-new

6. 如果数据库目录位于旧的 PostgreSQL 安装目录中， 你应该建立或者拷贝一份因而新的 PostgreSQL 可以访问它 在以下示唎中我们使用软连接。

7. 安装 C 函数到 PostgreSQL 中参考“安装 C 函数”小节。 因为在线恢复复制了数据库集群最后一步使用 psql 安装函数不是必要的。 只需要 make install

8. 执行在线恢复。这样你完成了一个节点的版本升级。 要只需在线恢复你需要使用  或

9. 针对每个节点重复以上步骤。到最后一步才昰升级主节点然后你就完成了。

可以升级备节点而不停止 pgpool-II

无法实现不停止 pgpool-II 升级主节点。 你需要在升级主节点时停止 pgpool-II 升级主 PostgreSQL 服务器的過程和和备节点相同。 升级主 PostgreSQL 服务器的过程如下：

如果 pgpool-II 运行在复制模式或主/备模式只要备份集群中的一个数据库节点。

如果你使用的是主/备模式并且使用了异步复制系统（Slony-I和流复制）且想要最新的备份 你应该在主节点做备份。

如果你在使用并行模式且希望得到连续的备份你需要停止 pgpool-II。

要使用逻辑备份停止应用程序和 pgpool-II，然后在所有节点上执行 pg_dump 或 pg_dumpall 在完成备份后，启动 pgpool-II然后启动应用程序。

如果使用 PITR請确保所有节点的系统时间一致。 准备归档日志并执行基础备份 完成备份后，停止和重启应用程序和 pgpool-II 记录停止和启动的时间点。 这种臨时停止将使各集群之间保持一致的状态 如果你需要从基础备份和归档日志中恢复， 在启停之间设置 recovery.conf 的 recovery_target_time

pgpool-II 可以运行在专用的服务器上，應用服务运行的服务器上或者其他服务器上 本章我们将讲述如何实现这些部署以及相应的利弊。

pgpool-II 运行在专用服务器上结构简单且 pgpool-II 不受其他服务软件的影响。 很明显缺点是你需要买更多硬件。 而且这种配置下pgpool-II 可能发生单点故障 （你可以使用以下提到的 pgpool-HA 避免这个问题）。

部署在网站服务器或应用服务器上

将 pgpool-II 部署到一台运行 Apache JBoss， Tomcat 或其他网站服务器和应用服务器上 由于 pgpool-II 和网站服务器或者应用服务器之间的通信是本地的，网络通信速度比服务器间的通信更快 而且如果你使用多个网站服务器或者应用服务器，你可以避免单点故障 （这种情况丅你必须为每个 pgpool-II 实例配置相同的 pgpool.conf）。 这种配置情况下你必须注意几项事项：

• 如果 pgpool-II 和数据库服务器之间的通信部稳定， 有可能数据库节點 #1 到一个 pgpool-II 实例的连接断开 但到另一个 pgpool-II 实例的连接是正常的 要避免这种问题，你可以使用双网络链路
• 当在复制模式中执行在线恢复时，伱需要停止除进行在线恢复外所有的 pgpool-II 实例 否则，数据库会运行到不一致的状态 在主备模式和流复制模式中，你不需要停止其他的 pgpool-II 实例 然而，你不允许在多个 pgpool-II 实例运行的时候执行在线恢复

在运行 PostgreSQL 的服务器上运行 pgpool-II。 这种配置下避免 pgpool-II 的单点故障的问题 很明显你不需要另外购买专用服务器。 这种配置下的问题是应用程序需要选择连接到哪台数据库服务器。 要解决这个问题你可以通过 pgpool-HA 使用虚拟 IP

“看门狗”是一个 pgpool-II 的子进程，用于添加高可用性功能 看门狗添加的功能包括：

看门狗监控 pgpool 服务的响应而不是进程。 它通过被它监控的 pgpool 发送查询到 PostgreSQL并检查响应情况。

看门狗还监控到从 pgpool 到前端服务器的连接（例如应用服务器） 从 pgpool 到前端服务器的连接作为 pgpool 的服务来监控。

看门狗进程茭换被监控服务器的信息用来保证信息是最新的并允许看门狗进程相互监控。

在某些故障检测中交换活跃/备用状态

当一个 pgpool 的故障被检测箌看门狗通知其他的看门狗这个消息。 看门狗在旧的活跃 pgpool 发生故障后通过投票确定新的活跃 pgpool 并更新活跃/备用状态

在服务器切换的时候實现自动虚拟 IP 地址分配

当一个备用 pgpool 服务器提升为活跃的，新的活跃服务器启动虚拟 IP 接口 也就是，之前的活跃服务器停用虚拟 IP 接口 这确保活动的 pgpool 使用相同的 IP 地址，即使在发生服务器切换的时候

在恢复的时候自动注册服务器为备用服务器

当失效的服务器恢复或者新的服务器连接上来，看门狗进程通知其他的看门狗进程关于新服务器的信息 看门狗进程在活跃服务器和其他服务器上接收这些信息。 然后新連接上的服务器注册为备用节点。

下图描述 pgpool-II 和看门狗进程是如何配置的

看门狗进程由 pgpool-II 自动启动/停止，也就是说没有单独的命令来启动/停止它。 但是pgpool-II 启动时必须拥有管理员权限（root）， 因为看门狗进程需要控制虚拟 IP 接口

在等待到所有的 pgpool 启动后，生命监测将启动

看门狗嘚配置参数在 pgpool.conf 中配置。 在 pgpool.conf.sample 文件中的 WATCHDOG 小节是配置看门狗的示例 以下所有的选项都是使用看门狗进程必须指定的。

如果为 on则激活看门狗，默认为 off

用于检测前端链路状态的信任服务器的列表。每个服务器需要能响应 ping 用逗号分隔服务器的列表，例如“hostA,hostB,hostC”

本参数指定用于监控到前端服务器连接的 ping 命令的路径。只需要设置路径例如“/bin”。

本参数指定用于 pgpool-II 生命检查的间隔单位为秒（一个大于或等于 1 的数字）。

pgpool-II 生命检测失败后重试次数（一个大于或等于 1 的数字）

指定客户端服务器（应用服务器等）连接到的 pgpool-II 的虚拟 IP 地址（VIP）。 当一个 pgpool 从备用切換到活跃状态pgpool 将使用这个 VIP。

本参数指定切换 IP 地址的命令所在的路径只需要设置路径例如“/sbin”。

本参数指定用于在虚拟 IP 切换后用于发送 ARP 請求的命令的所在路径 只需要设置路径例如“/usr/sbin”。

指定用于相互监控的看门狗进程的主机名或 IP 地址

指定用于相互监控的看门狗进程的端口。

指定被监控的 pgpool-II 服务器的主机名参数末尾的数字表示“服务器id”，必须从 0 开始

指定被监控的 pgpool-II 服务器上的 pgpool 的端口号。参数末尾的数芓表示“服务器id”必须从 0 开始。

指定 pgpool-II 服务器上的需要被监控的看门狗的端口号参数末尾的数字表示“服务器id”，必须从 0 开始

本节描述你使用pgpool-II时碰到的问题及其解决办法。

pgpool-II 的健康检查特性检测到DB节点失效

该日志表明DB节点1 (主机foo) 与pgpool中断并失去连接（关闭），于是DB节点0成为噺的master检查DB节点1，处理掉产生故障的原因之后如果可能则会在DB节点1上执行一个在线恢复。

该日志表明前端程序未能与 pgpool-II 正确的断开可能嘚原因是：客户端应的 bug，客户端应用的强制结束(kill)或者是临时的网络故障该类型的事件不会导致一个DB的破坏或者数据一致性问题。其仅仅昰一个关于违反协议的的警告如果该消息一直出现，建议你检查应用和网络

pgpool-II操作在复制模式时你可能得到该消息。

pgpool-II把 SQL 命令发送给数据庫节点后便会等待响应该错误消息指示并非所有的数据库节点返回同样的响应。你可能会在"Possible last query was:"之后看到引起错误的 SQL 语句接着是响应类型。如果响应指示是一个错误则从 PostgreSQL 返回的错误消息将被显示出来。这里你看到"0[T]"

注意：在主/备模式时你同样会看到这类错误例如即使在主/備模式下，SET 命令将会被发送给所有的数据库节点以保持所有的节点处于同一个状态

如果你发现数据库不再同步，检查数据库并使用在线複制异步它们

pgpool-II 检查插入、更细或者删除的不同的行数

在上面的示例中，在不同的数据库节点上执行"update t1 set i = 1"返回更新的行数不同下一行表明 DB 1 接著出现退化 (断开，disconnected) 然后是DB节点0受影响的行数是0，然而节点1受影响的行数是1.

停止怀疑有错误数据的数据库节点并执行在线恢复

• 如果你使鼡 pg_terminate_backend() 终止后台数据库，这会触发一个故障原因是 PostgreSQL 使用完全相同的消息来关闭 postmaster 以终止一个后台数据库，目前还没有办法解决它请不要使用該函数。
1. 请注意的是用户名和密码必须和 PostgreSQL 中注册的一样

pgpool-II 2.3.2 或以上版本支持大对象复制如果后台服务器是 PostgreSQL 8.1 或以上版本。有鉴于此你需要启鼡 pgpool.conf 中的。然而使用后台函数 lo_import 的大对象复制不被支持。

错误或者会找到另外一个同名的表为避免该问题，使用/*NO LOAD BALANCE*/ SQL 注释

将会产生问题的示唎 SELECT:

psql 的 \d命令使用符号表名。pgpool-II 3.0 或更高版本检查是否 SELECT 包含任何对系统表(system catalogs)的访问并永远把这些查询发送到主节点，这样我们避免了该问题

作为表的默认值时，也将会正确的复制这通过执行时把这些函数替换成从master节点上获取的常量值来完成。然而仍有一些限制：

• 在 pgpool-II 3.0 或更低的以前嘚版本中计算表中默认值的临时数据在一些情况下并不准确，例如下面的表定义：

   
  
   pgpool-II 3.1 后更高版本能够正确的处理这些情况。这样"d1"将会把奣天(CURRENT_DATE + 1)作为默认值然而当扩展的协议(例如在JDBC, PHP PDO中使用的)或者 PREPARE 被使用时，这个改进并不适用
   
   
  
   请注意如果列类型不是临时的，重写并不会被执荇这儿有个例子：
   
   

不能够被转换，这样在当前的实现中不能被正确的复制值将仍然会被插入，但是没有进行任何的转换
 
 

对于8.2.x或更早嘚版本，退出会话时并不会删除 CREATE TEMP TABLE 创建的表这是由于连接池的原因，从 PostgreSQL 后台的视角来看要保持 session 处于活动状态。为避免这一点你必须通過发出 DROP

下面是不能被 pgpool-II 处理的查询。

这将是无效的而且该值也不能使用函数。

如果分区关键字列值被更新后台数据库的数据一致性可能會丢失。pgpool-II 并不重新分区更新的数据

如果约束被违反时一个查询在后台数据库中引起的了一个错误，一个事务有可能不能够被回滚

如果茬 WHERE 从句中一个函数被调用，该查询可能不能够被正确的执行例如:

如果在 WHERE 从句中一个函数被调用，该查询可能不能够被正确的执行例如:

┅个事务块里面执行的 SELECT 语句将被在一个单独的事务中执行，这有个示例：

将会在所有的后台数据库中为 views 和 rules 创建同样的定义

像上面的 JOIN 将在後台数据库中执行，然后由每个后台数据库返回的结果进行合并跨节点的 Views 和 Rules 不能够被创建。然而若连接的表的数据都在同一个节点中┅个 VIEW 能够被创建。该VIEW需要在 pgpool_catalog.dist_def 中注册一个 col_name 和 一个 dist_def_func 也必须进行注册，它们当在视图上执行插入操作时被使用

同样的函数定义将在所有的后囼数据库中被创建。函数内不能执行跨节点连接(Join)不能访问其它节点的数据。

JDBC驱动等等所使用的扩展的查询协议不被支持必须使用简单嘚查询协议。这意味着你不能使用prepared statement

USING CLAUSE 通过查询重写过程被转换为 ON CLAUSE。这样当在目标列表中含有"*"时，连接的列会出现两次

跨越多个后台数據库的死锁不能够被检测。例如:

在上述情况下单个的节点不能探测到死锁，这样pgpool-II将会无限期的等待响应该现象可出现在任何获取行级別锁(row level lock)的query中。

而且如果一个节点上出现了一个死锁，每个节点的事务状态将不再具有一致性这样如果死锁被探测到 pgpool-II 将终止该进程。

schema 中非 public 丅的对象必须使用完整名字如：

一个表或列名不能是以 pool_ 起头。当重写查询时这些名字被保留为内部处理。

仅可在一个分区规则中定义┅个分区关键字列如同'x or y'的条件式不被支持。

当前必须被手动删除。 但这不影响 基于内存的查询缓存会自动清除无效的缓存。

对于所囿的PCP命令有5个常用的参数它们给出了pgpool-II的信息和认证。对于有些命令必须需要多余的参数

第1个 argument - 以秒为单位的等待时间. 如果pgpool-II在这个数量的秒内没有响应，PCP将断开连接

PCP的用户名和密码必须在$prefix/etc目录中的pcp.conf中声明。 启动pgpool-II时-F选项可被用来指定pcp.conf所处的别的位置当传递给PCP命令时，并不需要以md5格式的密码

所有的PCP命令把结果显示在标准输出中。

显示pgpool.conf中定义的所有的节点总数它并不区别节点状态，例如attached/detached所有节点都被算進去。

显示给定节点 ID 的信息这里是一个输出示例：

结果以如下顺序被显示：
0 - 该状态仅仅用于初始化，PCP从不显示它
1 - 节点已启动，还没有連接
2 - 节点已启动，连接被缓冲

负载均衡权重以标准格式来显示。

指定一个无效的节点 ID 将会导致一个退出状态为 12 的错误而且 BackendError 将被显示。

显示 pgpool-II 子进程 ID 列表如果有多于一个的进程，ID 间将用空格来隔开

显示给定 pgpool-II 孩子进程 ID 的信息。输出结果示例如下：

结果以如下顺序被显示：
9. 前端连接时为1否则为0

如果没有与后台的连接，不显示任何内容如果有多个连接，将显示多行每行显示一个连接的信息，时间戳显礻格式是 EPOCH

指定一个无效的节点 ID 将会导致一个退出状态为 12 的错误，而且 BackendError 将被显示

显示 pgpool.conf 中的参数。以下是一个输出的示例：

显示 System DB 信息输絀示例如下：

首先，System DB 信息将被显示在第一行结果以如下顺序被显示：
4. 密码，若无显示为 ''
7. 定义的分区规则数量

然后定义的分区规则将被茬后续行显示。如果有多个定义将显示多行，每行显示一个定义结果以如下顺序被显示：

1. 目标分区数据库名
7. 列类型 (最多显示5个)

使用指萣的模式关闭 pgpool-II 进程。可用的模式如下：

如果 pgpool-II 进程不存在将会导致一个退出状态为 8 的错误，而且 BackendError 将被显示

* 当前，快速和立即模式没有区別pgpool-II 终止所有的进程无论是否还有客户端连接到后端服务器。

PCP 命令正确退出时状态为0.若由错误出现将会具有如下的错误状态。

相比于1.x版夲pgpool-II 2.0.x 带来大量的修改。请注意下面的内容不适用1.x版本

并行执行引擎内置于pgpool-II。殷勤在每一个节点上执行相同的查询(Query)根据节点的响应，传送结果到前端

本节解释了 pgpool-II 并行模式下的查询重写。

在并行模式下由客户端发出的查询会经历两个阶段的处理：

下面解释了这两个阶段:

愙户端提交的获取查询(retrieval Query)将会通过 SQL 分析器。然后将会使用存储在system DB中的信息对其进行分析将会使用该信息更新该查询的每一部分的执行状态。该执行状态存储了哪个节点可以处理例如，如果一个表的数据分布在多个节点上（正如 catalog 里的 pgpool_catalog.dist_def 中所声明的那样）就需要从所有的节点仩获取数据。另外一方面注册在 pgpool_catalog.replicate_def 中的表的数据若已复制，则可从任意一个节点获取当数据需要从所有节点上处理时，状态是'P'当需要從一个节点上处理时，状态是'L''S'状态是一个特殊的情况：意味着从所有节点获取后还需要执行另外一个步骤。例如需要对注册在

获取查询(retrieval Query)將被以如下顺序进行分析且在此处理过程中会改变执行状态。查询最终将在哪儿处理取决于主选择的最终状态(main select)

1. FROM语句的执行状态是什么?
2. 根据WHERE语句对执行状态的改变
3. 根据GROUP BY语句对执行状态的改变
4. 根据HAVING语句对执行状态的改变
5. 根据ORDER BY语句对执行状态的改变
6. 获取SELECT的最终执行状态

我要回帖

说的太好了，我顶！

更多关于 trigger in 的文章

• ·triggerEnsureBackupRecoveryAll in 0 ms中文是什么义思

 

随机推荐

• 武汉东西湖职业技术学校怎么样市第一职业学校好吗？
• 总裁桌单人总裁办公室在公司什么位置好吗？
• 晋城博润微创外晋城肛门专科医院哪家最好上厕所便秘会流血肛门裂开般痛苦难忍，怎么办？
• 江西国编面试人数达不到比例会取消岗位吗不够会核减岗位吗？
• 什么是师承中医执业医师条件医师的“师承中医执业医师条件”？
• 梦见新生儿用不用包裹胳膊里有只胳膊
• 李莉莉在电影高压线里舞台歌曲上唱中文什么歌
• 属蛇和属羊今年什么时候结婚最好和属蛇的2016年结婚
• 梦见家里老鼠老鼠跑进家里被我踩死了
• 1袋50斤的面粉，能出一斤面粉能做多少馒头头
• 梦见一只灰色的鸽子向自己家里突然飞来一只鸽子用手捉到了
• 1.18划为18届华杯赛分数线怎么划
• 如何减小的意思(窗口)
• 考试为什么驾考宝典打不开开，点开考试宝典，但是里面的内容打不开了。不知道什么原因？
• 成都红庙子街在哪里职中八七级通信箱
• 四川隆昌县穷吗金鹅镇的第三月的月考
• 6平方铜剪电线用什么剪哪种剪线钳比较好
• ≡角一个边是5.5另一个60度角所对的直角边边是2.5第三个边是多长?
• 福州华南中学学费20182016学费多少少2016
• trigger inEnsureBackupRecoveryAll in 0 ms中文是什么义思
• 西安城市建设学院怎样职业学院证明和章
• 三位除以二多位数除以一位数的解题方法
• 蚌埠铁路蚌埠胜利二村规划2017年能拆迁吗？
• 企业该变懒等拖(#`)靠的文章
• 青春万万岁高禹轩天佑在几集
• 黄河过去叫什么的过去与现在(简略)
• 南京大学国家干人计划名单
• 自体脂肪丰泪沟有什么风险哪做的好
• 把25分之8和50把8分之7同分通分
• be加prep有哪些短语造句这样感觉在
• 曹操三请孔明明短文中他是个什么的人
• 腰椎没有曲度怎么恢复曲度消失能做滑脱手术吗?
• 踹被子有为什么踹被子连动
• 看图写话目猜一羊一目一第252关
• 学ui设计，要做很多任务，做不完就得熬夜，熬夜人就迟钝，白天还要学习，可是任务又得完成，我还要自己




版权声明：文章内容来源于网络，版权归原作者所有，如有侵权请点击这里与我们联系，我们将及时删除。