SQL Server MERGE语句报8672错误时如何实现表增量同步加载

问题根因 #

这个报错的核心逻辑非常明确：MERGE语句要求目标表的每一行最多只能匹配到源表的一行数据。你全量加载时每次都会清空Table_A再写入数据，不会出现同个匹配键多条数据的情况；但换成增量加载后，Table_A是追加写入，很容易出现同一个关联匹配键对应多条重复数据，导致匹配到目标表的同一行多次，触发8672报错。

解决方案 #

按优先级依次排查处理即可：

第一步：确认源表重复情况 #

先执行下面的SQL，确认你的MERGE关联字段在Table_A中是否存在重复：

-- 把下面的【关联键字段】替换成你MERGE语句ON后面的所有匹配字段
SELECT 关联键字段1, 关联键字段2, COUNT(*) AS 重复次数
FROM Table_A
GROUP BY 关联键字段1, 关联键字段2
HAVING COUNT(*) > 1;

如果查询有返回结果，说明确实是源表重复导致的问题，走第二步处理。如果没有返回结果，说明你MERGE的ON条件写漏了匹配字段，直接走第三步。

第二步：处理源表重复数据 #

不需要改现有逻辑的核心结构，只要把MERGE的源替换为去重后的数据集即可，优先保留最新的增量数据。
示例代码如下，替换对应字段即可直接使用：

MERGE Table_B AS target
USING (
    -- 子查询对源表去重，每个关联键只保留最新的一条数据
    SELECT * FROM (
        SELECT 
            *,
            -- 按关联键分组，按数据生成时间倒序，最新的数据排第一
            ROW_NUMBER() OVER(PARTITION BY 关联键字段1, 关联键字段2 ORDER BY 数据更新时间字段 DESC) AS rn
        FROM Table_A
        -- 如果有同步状态字段，这里可以加WHERE 同步状态 = '未同步' 缩小数据范围
    ) t WHERE rn = 1
) AS source
-- 这里保持你原来的关联条件不变
ON target.关联键字段1 = source.关联键字段1 AND target.关联键字段2 = source.关联键字段2
WHEN MATCHED THEN 
    -- 保持你原来的更新逻辑不变
    UPDATE SET target.普通字段1 = source.普通字段1, target.普通字段2 = source.普通字段2
WHEN NOT MATCHED THEN 
    -- 保持你原来的插入逻辑不变
    INSERT (关联键字段1, 关联键字段2, 普通字段1, 普通字段2) 
    VALUES (source.关联键字段1, source.关联键字段2, source.普通字段1, source.普通字段2);

如果不想每次MERGE都做子查询去重，也可以在增量数据写入Table_A之后先执行一次去重逻辑，把同一个关联键的旧数据删掉，只保留最新的一条，保证源表本身不存在重复即可。

第三步：补全MERGE关联条件 #

如果第一步没有查到源表重复，说明你MERGE的ON匹配条件少写了字段，比如实际需要用「用户ID+门店ID」两个字段作为唯一匹配键，你只写了「用户ID」，导致出现一对多的匹配，把所有需要的联合匹配字段都补到ON条件里即可解决。

优化建议 #

增量场景下可以给Table_A加一个is_sync同步状态字段，每次MERGE完成后把本次处理过的数据标记为已同步，下次MERGE时只处理未同步的数据，既可以提升性能，也能进一步避免重复处理历史数据。

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