DB2 SQL执行Merge语句报错SQL0788（状态21506）排查求助

这个问题我太熟悉了——SQL0788（伴随状态码21506）的核心原因其实和你排查的方向有点偏差，你漏查了源表table2自身的重复键值。

错误原因拆解 #

DB2的MERGE语句有个严格要求：对于目标表（table1）中的任意一条记录，在源表（table2）中通过匹配条件找到的记录必须是唯一的；就算是插入操作，源表中待插入的键值组合也不能重复（如果目标表的键是主键/唯一约束的话）。你的错误正是因为table2中存在同一个key1+key2组合对应多条记录的情况，导致DB2无法确定用哪一条源记录来更新目标表的匹配行。

你排查语句的问题 #

你用的排查语句是把table1和table2做内连接后分组：

select src.key1, src.key2, count(*) 
from table1 as tgt 
inner join table2 as src on tgt.key1 = src.key1 and src.key2 = src.key2 
group by src.key1, src.key2 
having count(*) > 1

这个语句只能查出table1中存在的键值，对应table2有多条记录的情况，但如果table2里本身就有重复的key1+key2（哪怕table1里没有对应的记录），这个语句是查不出来的——而这种情况恰恰会触发SQL0788错误。

正确的排查语句 #

直接检查table2自身的键值重复：

select key1, key2, count(*) 
from table2 
group by key1, key2 
having count(*) > 1;

执行这个语句，你应该能找到导致错误的重复键值组合。

解决办法 #

根据你的业务场景，有两种处理方式：

1. 清理源表重复数据：直接删除table2中重复的key1+key2记录，确保每个键值组合只有一条有效数据。
2. 聚合源表数据：如果table2中的重复记录是合法的（比如同一键值有不同版本的字段值），可以通过聚合函数（如MAX()、MIN()、ROW_NUMBER()取最新记录）来构建唯一的源数据集，再执行MERGE：

merge into table1 as tgt 
using (
    -- 这里用ROW_NUMBER()取每个key组合下最新的记录，你可以根据业务调整排序逻辑
    select key1, key2, fld1, fld2, fld3
    from (
        select 
            key1, key2, fld1, fld2, fld3,
            ROW_NUMBER() over (partition by key1, key2 order by some_timestamp_col desc) as rn
        from table2
    ) t
    where rn = 1
) as src 
on src.key1 = tgt.key1 and src.key2 = tgt.key2 
when matched then 
    update set (fld1, fld2, fld3) = (src.fld1, src.fld2, src.fld3) 
when not matched then 
    insert (fld1, fld2, fld3) values (src.fld1, src.fld2, src.fld3);

内容的提问来源于stack exchange，提问作者Francisco Costa