pgautofailover
PG 自动故障迁移
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pgautofailover | 2.2 | ADMIN | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 5150 | pgautofailover | 否 | 是 | 是 | 是 | 否 | 否 | - |
| 相关扩展 | btree_gist pglogical pglogical_origin pg_failover_slots pgpool_recovery repmgr pg_checksums pgpool_adm bgw_replstatus |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 2.2 | 1817161514 | pgautofailover | btree_gist |
| RPM | PGDG | 2.2 | 1817161514 | pg_auto_failover_$v | - |
| DEB | PGDG | 2.2 | 1817161514 | postgresql-$v-auto-failover | - |
安装
您可以直接安装 pgautofailover 扩展包的预置二进制包，首先确保 PGDG 仓库已经添加并启用：
pig repo add pgdg -u # 添加 PGDG 仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pgautofailover; # 当前活跃 PG 版本安装
pig ext install -y pgautofailover -v 18 # PG 18
pig ext install -y pgautofailover -v 17 # PG 17
pig ext install -y pgautofailover -v 16 # PG 16
pig ext install -y pgautofailover -v 15 # PG 15
pig ext install -y pgautofailover -v 14 # PG 14
dnf install -y pg_auto_failover_18 # PG 18
dnf install -y pg_auto_failover_17 # PG 17
dnf install -y pg_auto_failover_16 # PG 16
dnf install -y pg_auto_failover_15 # PG 15
dnf install -y pg_auto_failover_14 # PG 14
apt install -y postgresql-18-auto-failover # PG 18
apt install -y postgresql-17-auto-failover # PG 17
apt install -y postgresql-16-auto-failover # PG 16
apt install -y postgresql-15-auto-failover # PG 15
apt install -y postgresql-14-auto-failover # PG 14
预加载配置：
shared_preload_libraries = 'pgautofailover';
创建扩展：
CREATE EXTENSION pgautofailover CASCADE; -- 依赖: btree_gist
用法
pg_auto_failover 是一个用于 PostgreSQL 自动故障转移的扩展和服务。它由一个监控节点（运行 pgautofailover 扩展）和每个数据节点上由 pg_autoctl CLI 管理的 keeper 进程组成。
架构
- 监控节点：安装了
pgautofailover扩展的 PostgreSQL 实例，实现了用于故障转移决策的状态机 - Keeper（
pg_autoctl run）：运行在每个数据节点上，向监控节点报告健康状态并执行状态转换 - 支持 2 个以上节点的设置，默认使用同步复制
- 支持 Citus HA（v2.0 起）
关键 CLI 命令
# 创建监控节点
pg_autoctl create monitor --pgdata /path/to/monitor --pgport 5000
# 创建数据节点（自动分配为主节点或从节点）
pg_autoctl create postgres --pgdata /path/to/data --pgport 5001 --monitor postgres://monitor:5000/pg_auto_failover
# 运行 keeper（前台模式）
pg_autoctl run --pgdata /path/to/data
# 检查集群状态
pg_autoctl show state --pgdata /path/to/monitor
# 执行手动切换
pg_autoctl perform switchover --pgdata /path/to/monitor
# 执行手动故障转移
pg_autoctl perform failover --pgdata /path/to/monitor
故障转移行为
监控节点跟踪节点健康状态。当从节点不可用或其延迟过高时，会从主节点的 synchronous_standby_names 中移除。在从节点恢复健康之前，故障转移/切换操作会被阻止，以防止数据丢失。
文档
完整文档：pg-auto-failover.readthedocs.io