Postgres UPDATE被Debezium记为DELETE+INSERT的原因与解决咨询

1. Postgres为何会将UPDATE转换为DELETE+INSERT两条语句？ #

这是Postgres存储引擎的底层机制导致的：当你更新的字段属于**唯一约束（或唯一索引）**的组成部分时，Postgres无法执行原地的Heap-Only Tuple（HOT）更新——HOT更新仅适用于不修改索引列的场景，可复用现有索引条目。而修改唯一约束的列时，必须生成全新的行元组，同时将旧元组标记为删除（后续由VACUUM清理），这种操作在Postgres的WAL（Write-Ahead Log）中会被记录为一条DELETE和一条INSERT语句，Debezium通过读取WAL捕获变更，因此会解析出两条DML。

2. 是否有办法强制Postgres或Debezium将其记录为UPDATE语句？ #

Postgres端 #

没有办法强制改变这种行为，因为这是Postgres维护唯一索引一致性的必要逻辑——唯一索引需要指向更新后的新元组，旧元组必须被标记为失效，底层必然采用DELETE+INSERT的操作方式。除非调整表结构，将被更新的字段移出唯一约束，但这通常不符合业务需求。

Debezium端 #

可以通过配置转换器让Debezium将两条语句合并为一条UPDATE事件。在Postgres连接器的配置中添加以下参数：

transforms=unwrap
transforms.unwrap.type=io.debezium.transforms.UnwrapFromEnvelope
transforms.unwrap.add.fields=op
transforms.unwrap.delete.handling.mode=rewrite

该配置会让Debezium识别到Postgres生成的“删除旧元组+插入新元组”是逻辑上的UPDATE操作，最终输出单一的UPDATE变更事件。

3. 这是否与更新的字段属于外键及唯一约束索引有关？ #

直接相关，但核心原因是包含该字段的唯一约束（或唯一索引），而非外键。外键约束本身不会触发这种行为，但你更新的table2_id属于唯一约束的组成部分，这才导致Postgres采用DELETE+INSERT的底层逻辑。外键只是该字段的附加约束，不是触发问题的关键。

补充说明 #

你执行的UPDATE语句（修正拼写错误后）：

UPDATE Table1 
SET table2_id = :destinationTable2Id 
WHERE 
Table3_id IN (:table3Ids) AND 
Table2_id = :sourceTable2Id AND 
deleted_date is null

Table1结构中，table2_id、table3_id属于外键，且二者与其他字段共同构成唯一约束，更新table2_id时触发了上述Postgres底层更新逻辑，进而被Debezium解析为两条DML语句。

内容的提问来源于stack exchange，提问作者François-David Lessard