Dapper怎么处理SQL的MERGE语句 Dapper执行MERGE操作教程

月夜之吻 2025-12-25 00:00:00 次阅读

Dapper 本身不提供 MERGE 方法，需手写 T-SQL MERGE 语句并通过 Execute 执行；推荐参数化查询、确保目标表有主键或唯一约束；批量场景宜用表值参数（TVP）；也可借助第三方库 DapperPlus 的 BulkMerge 实现自动化。

Dapper 本身不直接提供 MERGE 方法，它是一个轻量级微 ORM，只扩展 IDbConnection，提供 Query、Execute 等基础方法。要执行 SQL Server 的 MERGE 语句，你得手写 T-SQL 并用 Execute 执行——和写普通 INSERT/UPDATE/DELETE 一样，只是 SQL 内容换成 MERGE。

Dapper 执行 MERGE 的基本方式

核心就是：拼好标准的 T-SQL MERGE 语句，用参数化方式传参，调用 connection.Execute(sql, parameters)。

MERGE 是原生 T-SQL 语法，Dapper 不封装它，也不解析它，只负责安全传参和执行
必须确保目标表有主键或唯一约束，MERGE 的 ON 条件才可靠
推荐使用命名参数（如 @Id、@Name），避免字符串拼接引发 SQL 注入或类型错误

带参数的 MERGE 示例（单条记录）

比如同步一个用户信息，存在则更新，不存在则插入：

string sql = @"
MERGE Users AS target
USING (SELECT @Id AS Id, @Name AS Name, @Email AS Email) AS source
ON target.Id = source.Id
WHEN MATCHED THEN
    UPDATE SET Name = source.Name, Email = source.Email
WHEN NOT MATCHED THEN
    INSERT (Id, Name, Email) VALUES (source.Id, source.Name, source.Email);";
var parameters = new { Id = 123, Name = "李四", Email = "lisi@example.com" };
int affected = connection.Execute(sql, parameters);

注意：SQL 中的 USING (...) 子查询是常见写法，让参数能被 MERGE 引用；也可以用临时表或表值参数（见下一条）。

批量 MERGE：用表值参数（TVP）更高效

一次处理几百上千条记录时，别循环 Execute，改用 TVP + MERGE。步骤分三步：

在数据库中创建用户定义表类型，例如：CREATE TYPE UserMergeType AS TABLE (Id INT, Name NVARCHAR(50), Email NVARCHAR(100))
C# 中构建 DataTable，填入数据，再包装成 SqlMapper.TableValuedParameter
SQL 中把 USING @tvp 替换掉子查询，MERGE 就自动批量处理整张表

这是真正高性能的批量 MERGE 方式，比逐条 Execute 快一个数量级以上。