Oracle中MERGE INTO必须用ON子句基于主键或唯一列设等值条件，禁止在ON中更新字段；源数据须为SELECT子查询；UPDATE/INSERT字段需与源列严格对齐；NULL值须用NVL/COALESCE标准化；过滤条件应下推至USING子查询以保性能。
Oracle中MERGE INTO的正确写法和必须指定的条件
MERGE INTO 不是万能的“upsert”，它要求明确区分匹配与不匹配的判断逻辑，核心在于 ON 子句必须提供可精确评估的等值条件（通常基于主键或唯一约束列），否则会报错 ORA-38104: Columns referenced in the ON Clause cannot be updated。
常见错误是把要更新的字段也放进 ON 条件里，比如写成 ON (t.id = s.id AND t.status = s.status) —— 这会导致 Oracle 认为你要在匹配时修改 t.status，违反语法限制。
-
ON子句只用于判断“行是否存在”，只能包含连接键（如id、code），不能含待更新字段 - 匹配后更新哪些字段、插入哪些字段，全部由
WHEN MATCHED THEN UPDATE SET ...和WHEN NOT MATCHED THEN INSERT ...分开控制 - 源数据必须来自
SELECT子查询（哪怕只查一行），不能直接写值列表；若需单行 upsert，可用SELECT ... FROM DUAL
MERGE INTO中UPDATE和INSERT的字段对齐规则
UPDATE 部分的 SET 列表和 INSERT 部分的字段列表，都必须严格对应源子查询（USING 后的 SELECT）的列别名或位置，且类型兼容。Oracle 不做隐式转换，类型不一致会直接报错 ORA-00932。
典型陷阱是源查询里用字符串拼接或函数处理字段，导致目标列无法赋值。例如目标表 name VARCHAR2(50)，但源查了 UPPER(name) AS name，虽然别名一样，但长度语义已变，某些版本会触发截断警告甚至失败。
- INSERT 的字段括号内列名顺序，必须和
VALUES中表达式的顺序完全一致 - UPDATE 的
SET后面推荐显式写column = source.column，避免因别名冲突误赋值 - 如果源查询有计算字段（如
SYSDATE + 1 AS next_date），INSERT 时直接用next_date，不要重复写表达式
如何安全处理NULL值匹配和唯一约束冲突
当连接键字段可能为 NULL 时，ON (t.col = s.col) 永远不成立（因为 NULL = NULL 为 FALSE），导致所有行都被当作“不存在”而执行 INSERT，极易违反唯一约束报 ORA-00001。
解决方法不是改用 IS NULL 判断（MERGE 的 ON 不支持复杂布尔逻辑），而是提前清洗或改用 NVL/COALESCE 统一空值标记：
MERGE INTO target t USING (SELECT id, NVL(code, '-1') AS code, name FROM source) s ON (t.id = s.id AND t.code = s.code) WHEN MATCHED THEN UPDATE SET t.name = s.name WHEN NOT MATCHED THEN INSERT (id, code, name) VALUES (s.id, s.code, s.name);
- 永远不要在
ON中直接比较可能为 NULL 的列，必须用NVL、COALESCE或函数标准化 - 如果业务上 NULL 确实代表“任意值”或“通配”，MERGE 本身不适用，应拆成先
SELECT COUNT(*)再分步处理 - 并发场景下，即使加了唯一索引，MERGE 仍可能因读写间隔产生冲突，建议外层加异常捕获（
EXCEPTION WHEN DUP_VAL_ON_INDEX）兜底
性能关键：WHERE子句必须下推到USING子查询中
MERGE 的 USING 子查询若未加过滤，会把全量数据拉进内存再逐行匹配，即使最终只影响几行，也会严重拖慢执行速度。Oracle 不会自动将 WHEN MATCHED THEN UPDATE WHERE ... 的条件下推到驱动查询。
正确做法是把业务过滤条件写在 USING 的 SELECT 里，而不是塞进 UPDATE SET ... WHERE：
-- ✅ 好：过滤在源头
MERGE INTO orders t
USING (SELECT * FROM staging_orders WHERE status IN ('NEW', 'PENDING')) s
ON (t.order_id = s.order_id)
WHEN MATCHED THEN UPDATE SET t.status = s.status
WHEN NOT MATCHED THEN INSERT VALUES (s.order_id, s.status, s.amount);
<p>-- ❌ 差：WHERE在UPDATE里，全量staging_orders先加载
WHEN MATCHED THEN UPDATE SET t.status = s.status WHERE s.status IN ('NEW', 'PENDING')-
USING子查询务必带WHERE，尤其源表很大时，这是性能分水岭 - 避免在
WHEN MATCHED THEN UPDATE后加WHERE——它只控制是否执行更新动作，不减少匹配扫描量 - 确保
ON中的连接字段有索引，否则 MERGE 会走全表扫描+嵌套循环，比单独 UPDATE/INSERT 更慢
实际用起来最麻烦的往往不是语法，而是 NULL 处理和并发冲突——这两点没压住，MERGE 看似简洁，运行起来却比分开写更难 debug。
