PostgreSQL / 系统课时

配置 Replica Identity

配置 Replica Identity

逻辑复制处理 UPDATE 和 DELETE 时,订阅端必须知道“原来的哪一行”需要被修改或删除。Replica Identity 就是这组行标识规则。本节重点处理无主键表,比较 DEFAULT、指定唯一索引、FULL 和 NOTHING 的取舍。

学习目标

  • 能解释 Replica Identity 为什么影响 UPDATE 和 DELETE 的逻辑复制。
  • 能为无主键表选择合适的行标识策略。
  • 能用系统目录验证当前 Replica Identity 是否配置正确。

UPDATE 和 DELETE 为什么需要行身份

INSERT 只需要把新行写到订阅端;UPDATE 和 DELETE 则必须先定位旧行。PostgreSQL 默认使用主键作为 Replica Identity,因此有主键的表通常不需要额外配置。

如果表没有可用的 Replica Identity,同时又被 Publication 发布 UPDATE 或 DELETE,发布端执行这些操作时会被拒绝。问题不在网络或订阅端,而在于 WAL 中缺少足以唯一定位旧行的信息。

选择合适的策略

策略 行身份来源 适用情况
DEFAULT 主键 首选方案;表已有稳定主键
USING INDEX 指定唯一索引 无主键,但有稳定业务唯一键
FULL 旧行的全部列 迁移期临时兜底,或暂时无法建立唯一键
NOTHING 不记录行身份 仅适合不发布 UPDATE、DELETE 的场景

USING INDEX 使用的索引必须满足 Replica Identity 的约束:唯一、非部分索引、不可延迟,并且索引列都应为 NOT NULL。与 FULL 相比,这种方式通常生成更小的旧行标识,也更利于订阅端定位目标行。

用唯一索引作为 Replica Identity

下面创建一张没有主键的遗留表,用不可为空的业务编号建立唯一索引,再把该索引指定为 Replica Identity。

sql
CREATE TABLE public.lr_legacy_account (
    account_no text NOT NULL,
    email text,
    balance numeric(12, 2) NOT NULL
);

CREATE UNIQUE INDEX lr_legacy_account_uidx
ON public.lr_legacy_account (account_no);

ALTER TABLE public.lr_legacy_account
REPLICA IDENTITY USING INDEX lr_legacy_account_uidx;

SELECT
    c.relname AS table_name,
    CASE c.relreplident
        WHEN 'd' THEN 'default'
        WHEN 'n' THEN 'nothing'
        WHEN 'f' THEN 'full'
        WHEN 'i' THEN 'index'
    END AS replica_identity,
    i.relname AS identity_index
FROM pg_class AS c
LEFT JOIN pg_index AS x
    ON x.indrelid = c.oid
   AND x.indisreplident
LEFT JOIN pg_class AS i
    ON i.oid = x.indexrelid
WHERE c.oid = 'public.lr_legacy_account'::regclass;

预期输出:

text
CREATE TABLE
CREATE INDEX
ALTER TABLE
      table_name       | replica_identity |      identity_index
-----------------------+------------------+---------------------------
 lr_legacy_account     | index            | lr_legacy_account_uidx

此时该表即使没有主键,也具备可用于逻辑复制 UPDATE 和 DELETE 的稳定行标识。业务唯一键必须真正保持唯一和不可为空,否则它不适合作为复制身份。

没有合适唯一键时使用 FULL

如果迁移窗口内暂时无法补主键或合格的唯一索引,可以把整行旧值作为 Replica Identity。

sql
ALTER TABLE public.lr_legacy_account
REPLICA IDENTITY FULL;

SELECT
    relname,
    relreplident
FROM pg_class
WHERE oid = 'public.lr_legacy_account'::regclass;

预期输出中的 f 表示 FULL:

text
ALTER TABLE
       relname         | relreplident
-----------------------+--------------
 lr_legacy_account     | f

FULL 的优点是无需先设计唯一键,适合迁移期快速消除复制阻塞;代价是更新或删除时需要记录更多旧行信息,宽表和高更新频率表会增加 WAL 体积,并可能让订阅端定位旧行更昂贵。因此它更适合作为过渡方案,而不是默认长期配置。

上线前按表确认身份策略

迁移前应逐表核对:有稳定主键就保留 DEFAULT;没有主键但存在合格唯一键时优先 USING INDEX;两者都没有时,再评估是否临时使用 FULL。NOTHING 只有在 Publication 明确不发布 UPDATE 和 DELETE 时才安全。

对于低停机迁移,Replica Identity 应在正式开启持续复制前完成配置和验证。这样可以把“运行时才发现某张表无法更新或删除”的故障,提前变成可检查、可修复的上线前问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 Replica Identity

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

登录哪都通