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。
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;预期输出:
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。
ALTER TABLE public.lr_legacy_account
REPLICA IDENTITY FULL;
SELECT
relname,
relreplident
FROM pg_class
WHERE oid = 'public.lr_legacy_account'::regclass;预期输出中的 f 表示 FULL:
ALTER TABLE
relname | relreplident
-----------------------+--------------
lr_legacy_account | fFULL 的优点是无需先设计唯一键,适合迁移期快速消除复制阻塞;代价是更新或删除时需要记录更多旧行信息,宽表和高更新频率表会增加 WAL 体积,并可能让订阅端定位旧行更昂贵。因此它更适合作为过渡方案,而不是默认长期配置。
上线前按表确认身份策略
迁移前应逐表核对:有稳定主键就保留 DEFAULT;没有主键但存在合格唯一键时优先 USING INDEX;两者都没有时,再评估是否临时使用 FULL。NOTHING 只有在 Publication 明确不发布 UPDATE 和 DELETE 时才安全。
对于低停机迁移,Replica Identity 应在正式开启持续复制前完成配置和验证。这样可以把“运行时才发现某张表无法更新或删除”的故障,提前变成可检查、可修复的上线前问题。