pglogical
PostgreSQL逻辑复制:三方扩展实现
仓库
2ndQuadrant/pglogical
https://github.com/2ndQuadrant/pglogical
源码
pglogical-2.4.6.tar.gz
pglogical-2.4.6.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pglogical | 2.4.6 | ETL | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 9500 | pglogical | 否 | 是 | 是 | 是 | 否 | 否 | pglogical |
| 9501 | pglogical_origin | 否 | 是 | 否 | 是 | 否 | 否 | pglogical_origin |
| 相关扩展 | decoderbufs wal2json dblink postgres_fdw pg_failover_slots pgactive repmgr kafka_fdw |
|---|---|
| 下游依赖 | pgl_ddl_deploy pglogical_ticker |
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 2.4.6 | 1817161514 | pglogical | - |
| RPM | PGDG | 2.4.6 | 1817161514 | pglogical_$v | - |
| DEB | PGDG | 2.4.6 | 1817161514 | postgresql-$v-pglogical | - |
安装
您可以直接安装 pglogical 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:
pig repo add pgdg -u # 添加 PGDG 仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展:
pig install pglogical; # 当前活跃 PG 版本安装
pig ext install -y pglogical -v 18 # PG 18
pig ext install -y pglogical -v 17 # PG 17
pig ext install -y pglogical -v 16 # PG 16
pig ext install -y pglogical -v 15 # PG 15
pig ext install -y pglogical -v 14 # PG 14
dnf install -y pglogical_18 # PG 18
dnf install -y pglogical_17 # PG 17
dnf install -y pglogical_16 # PG 16
dnf install -y pglogical_15 # PG 15
dnf install -y pglogical_14 # PG 14
apt install -y postgresql-18-pglogical # PG 18
apt install -y postgresql-17-pglogical # PG 17
apt install -y postgresql-16-pglogical # PG 16
apt install -y postgresql-15-pglogical # PG 15
apt install -y postgresql-14-pglogical # PG 14
预加载配置:
shared_preload_libraries = 'pglogical';
创建扩展:
CREATE EXTENSION pglogical;
用法
使用发布/订阅模型的 PostgreSQL 逻辑复制系统。无需触发器或外部程序。
启用
添加到 postgresql.conf:
wal_level = 'logical'
max_worker_processes = 10
max_replication_slots = 10
max_wal_senders = 10
shared_preload_libraries = 'pglogical'
CREATE EXTENSION pglogical;
提供者(发布者)设置
-- 在提供者上创建节点
SELECT pglogical.create_node(
node_name := 'provider1',
dsn := 'host=providerhost port=5432 dbname=mydb'
);
-- 将 public 模式中所有表添加到默认复制集
SELECT pglogical.replication_set_add_all_tables('default', ARRAY['public']);
-- 添加 public 模式中所有序列
SELECT pglogical.replication_set_add_all_sequences('default', ARRAY['public']);
订阅者设置
-- 在订阅者上创建节点
SELECT pglogical.create_node(
node_name := 'subscriber1',
dsn := 'host=subscriberhost port=5432 dbname=mydb'
);
-- 创建到提供者的订阅
SELECT pglogical.create_subscription(
subscription_name := 'subscription1',
provider_dsn := 'host=providerhost port=5432 dbname=mydb'
);
复制集管理
-- 创建自定义复制集
SELECT pglogical.create_replication_set('my_set');
-- 添加特定表
SELECT pglogical.replication_set_add_table('my_set', 'my_table', true);
-- 移除表
SELECT pglogical.replication_set_remove_table('my_set', 'my_table');
行和列过滤
-- 行过滤:仅复制匹配条件的行
SELECT pglogical.replication_set_add_table(
set_name := 'default',
relation := 'my_table',
row_filter := 'id > 1000'
);
-- 列过滤:仅复制特定列
SELECT pglogical.replication_set_add_table(
set_name := 'default',
relation := 'my_table',
columns := '{id, name, updated_at}'
);
订阅管理
-- 检查订阅状态
SELECT * FROM pglogical.show_subscription_status();
-- 删除订阅
SELECT pglogical.drop_subscription('subscription1');
关键特性
- 选择性复制(按表、行过滤、列过滤)
- 不同 PostgreSQL 主版本之间的复制
- 延迟复制
- 订阅者无需超级用户