pgactive

PostgreSQL多主逻辑复制

概览

扩展包名版本分类许可证语言
pgactive2.1.7ETLApache-2.0C
ID扩展名BinLibLoadCreateTrustReloc模式
9550pgactivepg_catalog
相关扩展pglogical pg_failover_slots repmgr bgw_replstatus pglogical_origin pglogical_ticker pgl_ddl_deploy decoderbufs

require libpgfeutils

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY2.1.71817161514pgactive-
RPMPIGSTY2.1.71817161514pgactive_$v-
DEBPIGSTY2.1.71817161514postgresql-$v-pgactive-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
d13.x86_64
d13.aarch64
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
u22.x86_64
u22.aarch64
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
u24.x86_64
u24.aarch64
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7
PIGSTY 2.1.7

构建

您可以使用 pig build 命令构建 pgactive 扩展的 RPM / DEB 包:

pig build pkg pgactive         # 构建 RPM / DEB 包

安装

您可以直接安装 pgactive 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pgactive;          # 当前活跃 PG 版本安装
pig ext install -y pgactive -v 18  # PG 18
pig ext install -y pgactive -v 17  # PG 17
pig ext install -y pgactive -v 16  # PG 16
pig ext install -y pgactive -v 15  # PG 15
pig ext install -y pgactive -v 14  # PG 14
dnf install -y pgactive_18       # PG 18
dnf install -y pgactive_17       # PG 17
dnf install -y pgactive_16       # PG 16
dnf install -y pgactive_15       # PG 15
dnf install -y pgactive_14       # PG 14
apt install -y postgresql-18-pgactive   # PG 18
apt install -y postgresql-17-pgactive   # PG 17
apt install -y postgresql-16-pgactive   # PG 16
apt install -y postgresql-15-pgactive   # PG 15
apt install -y postgresql-14-pgactive   # PG 14

预加载配置

shared_preload_libraries = 'pgactive';

创建扩展

CREATE EXTENSION pgactive;

用法

pgactive: PostgreSQL 双活复制扩展

pgactive 扩展为 PostgreSQL 提供双活(多主)复制,多个数据库实例可以同时接受写入并相互复制变更。

启用

CREATE EXTENSION pgactive;

概述

pgactive 使用逻辑复制作为基础实现双活复制。集群中的多个数据库可以接受变更并双向复制。

关键概念

  • 双活:所有节点同时接受读写
  • 异步:变更在节点之间异步复制
  • 冲突解决:应用程序必须处理来自多个写入者的冲突变更
  • 逻辑复制:使用 PostgreSQL 的逻辑解码来解释和应用变更

使用场景

  • 多区域高可用数据库集群
  • 减少应用程序与数据库之间的写入延迟
  • 蓝绿应用更新
  • 必须保持双方可写的系统间数据迁移

设计注意事项

使用 pgactive 的应用程序必须能够处理:

  • 写冲突:不同节点上对同一行的并发修改
  • 复制延迟:变更可能不会立即在所有节点上可见
  • 功能限制:某些功能如自增序列在跨节点时需要特殊处理

注意事项

  • 基于 PostgreSQL 的原生逻辑复制基础设施构建
  • 需要 PostgreSQL 10+(原生逻辑复制支持)
  • 详细设置和冲突解决策略请参阅项目文档

最后修改 2026-03-14: update extension metadata (953cbd0)