SQL Server MERGE语句多个When Matched Update子句替代方法

DevOps 小满

2026-9-1

错误原因

SQL Server 对 MERGE 语法有明确约束：同一条 MERGE 语句中最多只能存在一个 WHEN MATCHED THEN UPDATE 分支。原写法拆分了两个独立的MATCHED更新分支，分别处理业务字段更新、删除标记更新，直接触发了题述的语法报错。

正确实现方式

将两个MATCHED分支的更新逻辑合并到同一个WHEN MATCHED分支中，通过条件判断兼容两种更新场景，同时保留原有的字段差异校验逻辑，避免无意义的全量更新。
修正后的代码如下：

MERGE Destination d
USING @Source s
    ON d.DestinationId = s.DestinationId

-- 匹配到记录时，只要满足「业务字段有差异」或「需要标记删除」任意一个条件，就进入更新分支
WHEN MATCHED AND (
    ISNULL(d.DestinationFieldOne,0) != ISNULL(s.DestinationFieldOne,0) OR
    ISNULL(d.DestinationFieldTwo,'') != ISNULL(s.DestinationFieldTwo,'') OR
    ISNULL(d.DestinationFieldThree,'') != ISNULL(s.DestinationFieldThree,'') OR
    ISNULL(d.DestinationFieldFour,'') != ISNULL(s.DestinationFieldFour,'') OR
    @Deleted = 1
)
THEN UPDATE SET
    -- 仅当业务字段存在差异时更新对应字段，否则保留原值
    d.DestinationFieldOne = CASE 
        WHEN ISNULL(d.DestinationFieldOne,0) != ISNULL(s.DestinationFieldOne,0) 
        THEN s.DestinationFieldOne 
        ELSE d.DestinationFieldOne 
    END,
    d.DestinationFieldTwo = CASE 
        WHEN ISNULL(d.DestinationFieldTwo,'') != ISNULL(s.DestinationFieldTwo,'') 
        THEN s.DestinationFieldTwo 
        ELSE d.DestinationFieldTwo 
    END,
    d.DestinationFieldThree = CASE 
        WHEN ISNULL(d.DestinationFieldThree,'') != ISNULL(s.DestinationFieldThree,'') 
        THEN s.DestinationFieldThree 
        ELSE d.DestinationFieldThree 
    END,
    d.DestinationFieldFour = CASE 
        WHEN ISNULL(d.DestinationFieldFour,'') != ISNULL(s.DestinationFieldFour,'') 
        THEN s.DestinationFieldFour 
        ELSE d.DestinationFieldFour 
    END,
    -- 仅当@Deleted为1时标记删除，否则保留原有删除状态
    d.Deleted = CASE WHEN @Deleted = 1 THEN 1 ELSE d.Deleted END

-- 目标表无匹配记录时正常插入
WHEN NOT MATCHED BY TARGET
    THEN INSERT (DestinationFieldOne, DestinationFieldTwo, DestinationFieldThree, DestinationFieldFour) 
    VALUES (s.DestinationFieldOne, s.DestinationFieldTwo, s.DestinationFieldThree, s.DestinationFieldFour);

注意事项

SQL Server 要求 MERGE 语句必须以分号结尾，书写时不要遗漏末尾的分号，否则会触发语法错误。
上述写法兼容两个条件同时满足的场景：如果某条匹配记录既存在业务字段差异，又需要标记删除，会同时完成字段更新和删除标记操作，不会出现逻辑遗漏。
条件判断中保留了ISNULL空值处理逻辑，和原语句的空值比对规则保持一致，避免NULL值不等判断导致的逻辑错误。

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