spock

PostgreSQL 多主逻辑复制扩展

概览

扩展包名版本分类许可证语言
spock5.0.5ETLPostgreSQLC
ID扩展名BinLibLoadCreateTrustReloc模式
9560spockspock
相关扩展lolor snowflake

works on pgedge kernel fork

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY5.0.51817161514spock-
RPMPIGSTY5.0.51817161514spock_$vpgedge_$v
DEBPIGSTY5.0.51817161514pgedge-$v-spockpgedge-$v
OS / PGPG18PG17PG16PG15PG14
el8.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
el8.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
el9.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
el9.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
el10.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
el10.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
d12.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
d12.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
d13.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
d13.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
u22.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
u22.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
u24.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
u24.aarch64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS

构建

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

pig build pkg spock         # 构建 RPM / DEB 包

安装

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

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

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

pig install spock;          # 当前活跃 PG 版本安装
pig ext install -y spock -v 17  # PG 17
dnf install -y spock_17       # PG 17
apt install -y pgedge-17-spock   # PG 17

预加载配置

shared_preload_libraries = 'spock';

创建扩展

CREATE EXTENSION spock;

用法

spock: PostgreSQL 多主逻辑复制扩展

PostgreSQL 15+ 的多主逻辑复制。每个节点同时充当发布者和订阅者。

配置

postgresql.conf 中:

wal_level = 'logical'
max_worker_processes = 10
max_replication_slots = 10
max_wal_senders = 10
shared_preload_libraries = 'spock'
track_commit_timestamp = on
spock.enable_ddl_replication = on
spock.include_ddl_repset = on

启用

CREATE EXTENSION spock;

创建节点

在每个节点上创建节点身份:

-- 节点 1
SELECT spock.node_create(
    node_name := 'n1',
    dsn := 'host=10.0.0.5 port=5432 dbname=mydb'
);

-- 节点 2
SELECT spock.node_create(
    node_name := 'n2',
    dsn := 'host=10.0.0.7 port=5432 dbname=mydb'
);

创建订阅

对于多主,每个节点订阅其他所有节点:

-- 在 n1 上:订阅 n2
SELECT spock.sub_create(
    subscription_name := 'sub_n1n2',
    provider_dsn := 'host=10.0.0.7 port=5432 dbname=mydb'
);

-- 在 n2 上:订阅 n1
SELECT spock.sub_create(
    subscription_name := 'sub_n2n1',
    provider_dsn := 'host=10.0.0.5 port=5432 dbname=mydb'
);

复制集管理

-- 将表添加到复制
SELECT spock.repset_add_table('default', 'my_table');

-- 从复制中移除表
SELECT spock.repset_remove_table('default', 'my_table');

-- 添加模式中的所有表
SELECT spock.repset_add_all_tables('default', '{public}');

关键特性

  • 多主(双活)复制
  • 自动 DDL 复制
  • 使用提交时间戳进行冲突检测和解决
  • 行和列过滤
  • 支持 PostgreSQL 15、16、17 和 18
  • 表必须有主键且跨节点模式匹配

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