30分钟征服复杂SQL：Dapper实战指南从入门到精通

为什么选择Dapper？

你是否还在为Entity Framework的性能问题而烦恼？是否觉得手写ADO.NET代码过于繁琐？Dapper作为一款轻量级ORM（对象关系映射）工具，完美平衡了性能与开发效率，让你用最少的代码实现高效的数据访问。

Dapper最初由Stack Overflow开发并开源，它通过扩展方法增强ADO.NET连接，提供了简单而高效的API来执行SQL查询。无论是同步还是异步数据访问，Dapper都能轻松应对。

快速开始：安装与基础配置

安装Dapper

通过NuGet包管理器安装Dapper核心库：

Install-Package Dapper

或者如果你需要强名称版本：

Install-Package Dapper.StrongName

官方文档：README.md

第一个Dapper查询

下面是一个简单的查询示例，展示如何使用Dapper从数据库中获取数据：

using (IDbConnection connection = new SqlConnection(connectionString))
{
    var posts = connection.Query<Post>("SELECT * FROM Posts").ToList();
}

这段代码通过Query<T>方法执行SQL查询，并将结果直接映射到Post对象列表。Dapper会自动处理结果集到对象的映射，大大减少了手动处理数据读取的代码量。

Dapper核心功能详解

参数化查询

Dapper支持多种参数传递方式，有效防止SQL注入攻击：

// 匿名类型参数
var user = connection.QueryFirstOrDefault<User>(
    "SELECT * FROM Users WHERE Id = @Id", 
    new { Id = 1 });

// DynamicParameters参数
var parameters = new DynamicParameters();
parameters.Add("@Id", 1);
var user = connection.QueryFirstOrDefault<User>("SELECT * FROM Users WHERE Id = @Id", parameters);

参数化查询的实现细节可以在Dapper/SqlMapper.cs中找到，Dapper会自动处理参数的类型映射和SQL生成。

多结果集映射

Dapper能够轻松处理存储过程返回的多个结果集：

using (var multi = connection.QueryMultiple("GetPostAndComments", new { PostId = 1 }, commandType: CommandType.StoredProcedure))
{
    var post = multi.Read<Post>().Single();
    var comments = multi.Read<Comment>().ToList();
    post.Comments = comments;
}

这种方式避免了多次数据库往返，显著提升了性能。

事务管理

Dapper简化了事务处理，确保数据一致性：

using (var transaction = connection.BeginTransaction())
{
    try
    {
        connection.Execute("INSERT INTO Posts (Title, Content) VALUES (@Title, @Content)", post, transaction);
        connection.Execute("INSERT INTO Comments (PostId, Text) VALUES (@PostId, @Text)", comments, transaction);
        transaction.Commit();
    }
    catch
    {
        transaction.Rollback();
        throw;
    }
}

高级技巧：提升查询性能

缓存机制

Dapper内置了查询缓存机制，减少重复查询的开销：

// 清除查询缓存
SqlMapper.PurgeQueryCache();

缓存实现细节可以在Dapper/SqlMapper.cs文件中查看，Dapper会缓存查询计划和结果映射信息，大幅提升重复查询的性能。

批量操作

使用Dapper的Execute方法可以轻松实现批量插入：

var posts = new List<Post>
{
    new Post { Title = "Dapper教程1", Content = "..." },
    new Post { Title = "Dapper教程2", Content = "..." }
};

connection.Execute("INSERT INTO Posts (Title, Content) VALUES (@Title, @Content)", posts);

这种方式比逐条插入效率高得多，特别是当处理大量数据时。

实战案例：复杂查询与多表关联

多表关联查询

Dapper的多映射功能允许你将多个表的查询结果映射到复杂对象：

var sql = @"
    SELECT p.*, u.* 
    FROM Posts p
    LEFT JOIN Users u ON p.AuthorId = u.Id
    WHERE p.Id = @PostId";

var post = connection.Query<Post, User, Post>(
    sql,
    (post, user) => { post.Author = user; return post; },
    new { PostId = 1 },
    splitOn: "Id").FirstOrDefault();

这个例子展示了如何将Posts表和Users表的关联查询结果映射到包含作者信息的Post对象。

动态SQL构建

使用Dapper.SqlBuilder构建动态SQL查询：

var builder = new SqlBuilder();
var selector = builder.AddTemplate("SELECT * FROM Posts /**where**");

if (!string.IsNullOrEmpty(searchTerm))
{
    builder.Where("Title LIKE @SearchTerm OR Content LIKE @SearchTerm", new { SearchTerm = $"%{searchTerm}%" });
}

if (minDate.HasValue)
{
    builder.Where("CreatedDate >= @MinDate", new { MinDate = minDate });
}

var posts = connection.Query<Post>(selector.RawSql, selector.Parameters).ToList();

SqlBuilder组件：Dapper.SqlBuilder/SqlBuilder.cs

性能对比：为什么Dapper如此之快？

Dapper以其卓越的性能著称，让我们看看它与其他ORM的对比：

ORM	方法	平均耗时	分配内存
Dapper	QueryFirstOrDefault	133.73 us	11608 B
EF Core	First (Compiled)	265.45 us	7521 B
NHibernate	Get	276.02 us	29885 B
EF 6	First	310.55 us	43309 B

数据来源：benchmarks/Dapper.Tests.Performance

Dapper的高性能得益于其精简的设计和查询缓存机制，它避免了传统ORM的许多开销，同时保持了出色的开发体验。

常见问题与最佳实践

参数化IN查询

处理IN子句时，Dapper会自动参数化集合：

var postIds = new List<int> { 1, 2, 3 };
var posts = connection.Query<Post>("SELECT * FROM Posts WHERE Id IN @PostIds", new { PostIds = postIds });

Dapper会自动将其转换为参数化查询，避免SQL注入风险。

处理大数据集

对于大数据集，使用非缓冲查询减少内存占用：

var posts = connection.Query<Post>("SELECT * FROM LargeTable", buffered: false);

foreach (var post in posts)
{
    // 处理每个项目
}

总结与进阶学习

通过本文，你已经掌握了Dapper的核心功能和使用技巧。Dapper以其简洁的API、卓越的性能和强大的功能，成为.NET开发者的理想选择。

要深入学习Dapper，可以参考以下资源：

• 官方文档：docs/index.md
• 高级功能：Dapper.Rainbow
• 性能测试：benchmarks/Dapper.Tests.Performance

现在，你已经准备好用Dapper来优化你的数据访问层了。开始使用Dapper，体验高效数据访问的乐趣吧！

下一步行动

1. 将Dapper集成到你的下一个项目中
2. 尝试实现一个复杂的多表关联查询
3. 比较Dapper与你当前使用的ORM的性能差异
4. 探索Dapper的高级功能，如类型处理器和自定义映射

祝你使用Dapper愉快！