SQL Server的MERGE必须同时包含WHEN MATCHED和WHEN NOT MATCHED分支，否则报错；Oracle则允许省略任一分支。两者在参数占位符、NULL处理、USING语法及索引要求上存在显著差异，跨库移植需方言适配。
SQL Server 的 MERGE 语法必须带 WHEN MATCHED 和 WHEN NOT MATCHED
SQL Server 不允许只写一半逻辑——哪怕你只想更新、不想插入，也得显式写出 WHEN NOT MATCHED THEN INSERT ... VALUES (...)（哪怕里面是空操作或 throw 错误），否则报错 The MERGE statement attempted to UPDATE or DELETE the same row more than once 或直接语法拒绝。
常见错误是漏掉 WHEN NOT MATCHED 分支，或把 INSERT 写成 INSERT INTO ... SELECT 却没加 VALUES 子句；正确模板如下：
MERGE target_table AS t USING (SELECT @id AS id, @name AS name, @age AS age) AS s ON t.id = s.id WHEN MATCHED THEN UPDATE SET name = s.name, age = s.age WHEN NOT MATCHED THEN INSERT (id, name, age) VALUES (s.id, s.name, s.age);
-
USING子句必须返回结果集，不能直接用值列表（如USING (VALUES (@id, @name))是合法的，但需指定列别名） -
ON条件里不能出现NULL比较（t.id = s.id在任一为NULL时恒为UNKNOWN，导致匹配失败，应提前过滤或用IS NULL显式处理） - 若目标表有触发器，
MERGE可能被拆成多个语句执行，触发器行为与单独UPDATE/INSERT不一致
Oracle 的 MERGE 允许省略 INSERT 或 UPDATE 分支
Oracle 更宽松：你可以只写 WHEN MATCHED THEN UPDATE（实现“仅更新不插入”），或只写 WHEN NOT MATCHED THEN INSERT（实现“仅插入不更新”），不会报错。但要注意 UPDATE 后必须跟 SET，且不能写 WHERE 子句在 UPDATE 后面（那是 SQL Server 写法，Oracle 不支持）。
标准 upsert 模板如下：
MERGE INTO target_table t USING (SELECT :id AS id, :name AS name, :age AS age FROM DUAL) s ON (t.id = s.id) WHEN MATCHED THEN UPDATE SET t.name = s.name, t.age = s.age WHEN NOT MATCHED THEN INSERT (id, name, age) VALUES (s.id, s.name, s.age);
-
USING必须带FROM DUAL（即使单行），否则报ORA-00928: missing SELECT keyword -
ON条件支持IS NULL，比如t.id = s.id OR (t.id IS NULL AND s.id IS NULL)可用于处理空值键 - Oracle 12c+ 支持
INSERT ... ON DUPLICATE KEY UPDATE风格的INSERT语句，但那不是MERGE，而是独立语法，兼容性不如MERGE
跨数据库移植时最常踩的坑：参数占位符和空值处理
SQL Server 用 @param，Oracle 用 :param 或 ¶m，拼错就直接报错；更隐蔽的是空值逻辑——SQL Server 的 = 对 NULL 返回 UNKNOWN，Oracle 同样如此，但开发者常默认它“等于 false”，结果 ON t.id = s.id 在 s.id 为 NULL 时永远不匹配，导致意外插入重复空键记录。
- 统一做法：在
USING子句中对可能为空的键字段做COALESCE(s.id, -999999)（SQL Server）或NVL(s.id, -999999)（Oracle），并在目标表对应字段建函数索引（如需要） - 不要依赖客户端传入非空校验——数据库层必须兜底，否则并发下容易产生脏数据
- SQL Server 中
MERGE是语句级原子操作，但内部可能分多步执行；Oracle 的MERGE同样不保证单次锁全表，高并发时仍需考虑唯一索引 + 重试机制
性能关键点：ON 条件必须走索引，且避免复杂表达式
无论 SQL Server 还是 Oracle，MERGE 的 ON 条件如果无法利用索引（比如写成 UPPER(t.code) = UPPER(s.code)），就会触发全表扫描，upsert 100 行可能比 100 次单独 UPDATE 还慢。
- 确保
ON左侧字段（目标表）上有索引，且类型与右侧完全一致（比如INT对INT，不是INT对VARCHAR） - 避免在
ON中调用函数、类型转换、ISNULL/NVL——这些都会让索引失效 - SQL Server 中，如果
USING是大结果集（如子查询返回万级行），建议先插入临时表并建索引，再MERGE，否则优化器容易选错执行计划
