如何让Dapper将批量插入合并为单次数据库操作以减少数据库往返？

这确实是个很常见的性能优化需求——Dapper默认处理批量插入时，确实会拆成多条独立的INSERT语句执行，导致多次数据库往返。不过咱们有几种不用手动拼SQL的优雅方式来实现单次操作：

这是SQL Server官方推荐的批量操作方案，Dapper对它支持得非常好，既安全又高效，步骤如下：

1. 先在数据库中创建对应的用户定义表类型：

CREATE TYPE TestTableType AS TABLE (
    a VARCHAR(50), -- 和你的test表字段类型匹配
    b VARCHAR(50)
);

2. 在C#代码中准备好要插入的数据集合，然后通过Dapper的Execute方法传递这个集合作为表值参数：

// 假设你有对应的实体类
public class TestModel
{
    public string a { get; set; }
    public string b { get; set; }
}

// 准备数据
var dataList = new List<TestModel>
{
    new TestModel { a = "b", b = "c" },
    new TestModel { a = "d", b = "e" },
    new TestModel { a = "f", b = "g" }
};

// 执行批量插入
using (var conn = new SqlConnection("你的数据库连接字符串"))
{
    var sql = "INSERT INTO test (a, b) SELECT a, b FROM @Data";
    conn.Execute(sql, new { Data = dataList.AsTableValuedParameter("TestTableType") });
}

这种方式会把整个数据集合作为一个参数传递给数据库，只需要一次往返，完全避免了SQL注入风险。

对于支持多行INSERT语法的数据库（比如MySQL、PostgreSQL），Dapper会自动帮你把集合转换成单条多行VALUES的INSERT语句，不需要额外操作：

var dataList = new List<TestModel>
{
    new TestModel { a = "b", b = "c" },
    new TestModel { a = "d", b = "e" },
    new TestModel { a = "f", b = "g" }
};

using (var conn = new MySqlConnection("你的MySQL连接字符串"))
{
    var sql = "INSERT INTO test (a, b) VALUES (@a, @b)";
    // Dapper会自动把集合转换成 INSERT INTO test (a,b) VALUES ('b','c'),('d','e'),('f','g')
    conn.Execute(sql, dataList);
}

这种方式同样只需要一次数据库往返，代码也很简洁。

为什么SQL Server默认不会自动拼接多行VALUES？因为早期SQL Server版本对单条SQL语句的长度有限制，而表值参数是更稳定、更适合大规模数据的批量操作方案。如果你的SQL Server版本较新（2012+），其实也支持多行VALUES，但TVP依然是更优选择。

内容的提问来源于stack exchange，提问作者h-rai