SQL UPSERT 插入更新冲突解决方法实践

6次阅读

upsert非标准sql语法,是“存在则更新、不存在则插入”的统称;postgresql用on conflict,mysql用on duplicate key update,sql server用merge,sqlite用replace或insert or ignore/select+where not exists,均依赖唯一约束且需注意并发与语义陷阱。

SQL UPSERT 插入更新冲突解决方法实践

SQL 中的 UPSERT(即“插入或更新”)不是标准 SQL 语法,而是对“当记录存在则更新、不存在则插入”这一常见业务逻辑的统称。不同数据库实现方式差异较大,直接写错容易导致重复插入、丢失更新或死锁。下面按主流数据库分场景说明实用做法和避坑要点。

PostgreSQL:ON CONFLICT 是最稳的选择

PostgreSQL 从 9.5 起原生支持 INSERT ... ON CONFLICT,语义清晰、原子性强、性能好。

  • 必须指定冲突目标(通常是主键或唯一索引列),例如 ON CONFLICT (id)ON CONFLICT ON CONSTRAINT users_pkey
  • DO UPDATE SET 后可引用排除行(EXCLUDED)和原表行(如 users.name),避免手动写子查询
  • 慎用 WHERE 条件在 DO UPDATE 中——若条件不成立,该行会被静默跳过(既没插也没更),容易误判成功

示例:

INSERT INTO users (id, name, email, updated_at) VALUES (123, 'Alice', 'alice@example.com', NOW()) ON CONFLICT (id) DO UPDATE SET   name = EXCLUDED.name,   email = EXCLUDED.email,   updated_at = NOW();

MySQL:INSERT … ON DUPLICATE KEY UPDATE 简单但有陷阱

MySQL 不支持标准 UPSERT,但 INSERT ... ON DUPLICATE KEY UPDATE 能覆盖大部分场景。

  • 只响应 唯一约束冲突(主键或 UNIQUE 索引),普通索引无效
  • VALUES(col) 引用的是本次 INSERT 的原始值(不是新计算值),适合简单赋值;复杂逻辑建议用 if() 或提前计算好
  • 注意自增 ID 行为:即使触发 UPDATE,自增计数器仍会递增,可能导致 ID 空洞

示例:

INSERT INTO users (id, name, email, updated_at) VALUES (123, 'Alice', 'alice@example.com', NOW()) ON DUPLICATE KEY UPDATE   name = VALUES(name),   email = VALUES(email),   updated_at = NOW();

SQL Server:MERGE 语句功能强但易出错

SQL Server 推荐用 MERGE,它支持 INSERT/UPDATE/delete 多操作合一,但语法复杂、并发下易死锁。

  • 必须配对 WHEN MATCHEDWHEN NOT MATCHED,漏写会导致部分逻辑失效
  • 源数据需确保无重复键,否则报错“The MERGE statement attempted to update or delete the same row more than once”
  • 高并发时建议加 HOLDLOCK(等价于 SERIALIZABLE)防止幻读干扰匹配判断

示例:

MERGE users WITH (HOLDLOCK) AS target USING (SELECT 123 AS id, 'Alice' AS name, 'alice@example.com' AS email, GETDATE() AS updated_at) AS source ON target.id = source.id WHEN MATCHED THEN   UPDATE SET name = source.name, email = source.email, updated_at = source.updated_at WHEN NOT MATCHED THEN   INSERT (id, name, email, updated_at) VALUES (source.id, source.name, source.email, source.updated_at);

SQLite:REPLACE INTO 或 INSERT OR … 选对语义

SQLite 提供两种风格:REPLACE INTO 是“删+插”,INSERT OR IGNORE/REPLACE 更可控。

  • REPLACE INTO 本质是 DELETE + INSERT,会触发删除相关外键级联、触发器,且自增 ID 重置,慎用于有依赖关系的表
  • INSERT OR REPLACE 行为同上;INSERT OR IGNORE 遇冲突直接跳过,适合幂等初始化
  • 若需真正“存在则更新”,得用 INSERT ... SELECT ... WHERE NOT EXISTS 组合,略繁琐但语义精准

示例(安全更新):

INSERT INTO users (id, name, email, updated_at) SELECT 123, 'Alice', 'alice@example.com', datetime('now') WHERE NOT EXISTS (SELECT 1 FROM users WHERE id = 123);  UPDATE users SET   name = 'Alice',   email = 'alice@example.com',   updated_at = datetime('now') WHERE id = 123;

不复杂但容易忽略:所有 UPSERT 操作都依赖唯一性约束定义是否“冲突”。建表时务必确认主键或唯一索引已就位,否则语句不报错但逻辑失效。另外,批量处理时优先考虑数据库原生批量 UPSERT 语法,而非循环单条执行,性能差距可达数量级。

text=ZqhQzanResources