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 语法,而是对“当记录存在则更新、不存在则插入”这一常见业务逻辑的统称。不同数据库实现方式差异较大,直接写错容易导致重复插入、丢失更新或死锁。下面按主流数据库分场景说明实用做法和避坑要点。
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 MATCHED和WHEN 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 语法,而非循环单条执行,性能差距可达数量级。










