Postgres逻辑复制：UPDATE事件如何仅获取变更列值？

核心原因 #

你遇到的问题本质是逻辑复制输出插件的配置或特性支持问题，具体分为三类情况：

1. 插件默认行为：多数Postgres逻辑复制插件（比如官方的pgoutput）默认会发送UPDATE操作的完整新行数据，而非仅变更列。比如pgoutput的publish_update_full参数默认值为true，这会强制返回所有列的新值（用b表示非空值、n表示空值），不会生成u标识。
2. 插件不支持差异输出：部分轻量插件（比如test_decoding）本身不支持输出未修改列的u标识，无论如何配置都会返回全量列数据。
3. 表缺少唯一标识：如果目标表没有主键或唯一约束，插件无法精准定位变更行，只能退化为发送全量列数据，无法生成差异标识。

解决方案 #

根据你使用的插件类型，对应调整配置：

情况1：使用官方pgoutput插件 #

1. 重新创建发布并关闭全量更新：
   执行以下SQL修改发布配置，让插件仅发送变更列：

   -- 先删除原有发布（如果已存在）
   DROP PUBLICATION IF EXISTS your_publication_name;
   -- 创建带差异输出的发布
   CREATE PUBLICATION your_publication_name
   FOR TABLE your_target_table
   WITH (publish_update_full = false, publish_insert = true, publish_delete = true);
   

2. 确保表有主键/唯一约束：
   若表没有唯一标识，执行以下SQL添加主键（示例）：

   ALTER TABLE your_target_table ADD PRIMARY KEY (your_primary_key_column);
   

情况2：使用第三方插件（如wal2json） #

修改插件的配置参数，以wal2json为例：

1. 在postgresql.conf中添加或修改参数：

   wal2json.include-unmodified-cols = false
   

2. 重启Postgres服务使配置生效，之后插件会仅输出变更列，未修改列不会出现在TupleData中。

情况3：更换支持差异输出的插件 #

如果当前使用的插件不支持u标识输出（比如test_decoding），建议切换到pgoutput或wal2json这类支持差异输出的插件。

内容的提问来源于stack exchange，提问作者S.A.N