PostgreSQL / 系统课时

创建 Subscription 与复制槽

创建 Subscription 与复制槽

创建 Subscription 不只是保存一条连接配置:它会把订阅定义、发布端逻辑复制槽和订阅端复制进度关联起来。本节用一条可验证的创建命令,建立这三者的关系,并说明启停、删除时哪些资源仍会继续存在。

学习目标

  • 使用明确的连接信息、Publication 和槽名创建 Subscription
  • 说明 Subscription、发布端 replication slot 与订阅端 replication origin 的职责
  • 从发布端和订阅端检查创建结果,并理解资源生命周期

创建前先确认边界

Subscription 创建在订阅端数据库。发布端必须已经存在要订阅的 Publication,订阅端也必须先准备好匹配的表结构;逻辑复制传输行级变化,不负责替你创建表、索引或约束。发布端还需要启用逻辑 WAL,并为主复制槽以及可能出现的表同步槽预留足够容量。

当 create_slot = true 时,CREATE SUBSCRIPTION 会连接发布端并创建远程逻辑复制槽,因此不要把这条语句放进显式事务块。连接串属于敏感配置,示例中的 <IP>、<PORT> 与 <PASSWORD> 都应替换为实际值,并限制无关角色读取订阅连接信息。

创建 Subscription

下面假设发布端数据库为 appdb,已经存在 orders_pub,订阅端已经创建了 Publication 中涉及的同名表。显式指定 slot_name,能让运维检查时不必依赖默认命名。本节暂时使用 copy_data = false,把注意力集中在订阅、槽与增量应用链路上。

sql
CREATE SUBSCRIPTION orders_sub
CONNECTION 'host=<IP> port=<PORT> dbname=appdb user=replicator password=<PASSWORD>'
PUBLICATION orders_pub
WITH (
  slot_name = 'orders_sub_slot',
  create_slot = true,
  enabled = true,
  copy_data = false
);

预期输出

text
CREATE SUBSCRIPTION

create_slot = true 表示由 PostgreSQL 自动在发布端创建主逻辑复制槽;enabled = true 表示事务提交后允许 apply worker 启动。若不写 slot_name,通常会使用 Subscription 名称作为槽名;迁移项目中显式命名更便于脚本、监控和清理动作保持一致。

看懂 Subscription、Slot 与 Origin

Subscription、复制槽与复制 Origin 的关系

三者解决的是不同问题:Subscription 保存“连接哪个发布端、订阅哪些 Publication、使用哪个槽”等配置;发布端 replication slot 记录下游需要的 WAL 边界,保证未被消费的逻辑变化不会过早丢失;订阅端 replication origin 则记录远端变化已经重放到什么位置,用于崩溃后的安全进度恢复。

在当前 PostgreSQL 中,Subscription 的 subslotname 同时也是本地 replication origin 使用的名称。因此,把槽名作为跨两端排障的关联键非常实用:发布端查槽,订阅端查 Subscription 与 Origin,可以把“发送位置”和“应用位置”串起来。

从两端验证与管理生命周期

先在订阅端确认定义是否落入 pg_subscription。

sql
SELECT subname, subenabled, subslotname, subpublications
FROM pg_subscription
WHERE subname = 'orders_sub';

预期结果

text
 subname    | subenabled |   subslotname    | subpublications
------------+------------+------------------+-----------------
 orders_sub | t          | orders_sub_slot  | {orders_pub}

再到发布端检查主逻辑复制槽。数据库名应为发布端的 appdb;动态 LSN 不必写死,因此这里只验证稳定字段。

sql
SELECT slot_name, plugin, slot_type, database
FROM pg_replication_slots
WHERE slot_name = 'orders_sub_slot';

预期结果

text
    slot_name     |  plugin  | slot_type | database
------------------+----------+-----------+----------
 orders_sub_slot  | pgoutput | logical   | appdb

apply worker 初始化后,还可以在订阅端用同一个名称查看 replication origin。若这里为空,应继续检查 Subscription 是否启用、连接是否成功以及 worker 是否正在运行。

sql
SELECT roname
FROM pg_replication_origin
WHERE roname = 'orders_sub_slot';

预期结果

text
      roname
------------------
 orders_sub_slot

ALTER SUBSCRIPTION orders_sub DISABLE 只会停止订阅 worker,不会自动删除发布端主槽,因此不能把“停订阅”等同于“释放 WAL 保留责任”。正常执行 DROP SUBSCRIPTION orders_sub 时,PostgreSQL 会尝试同时删除关联的远程槽;若发布端不可达,清理可能失败,此时应先明确槽的归属与保留需求,再做人工解关联和远端槽清理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 Subscription 与复制槽

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通