【C#/.NET】Dapper使用QueryMultipleAsync执行多条SQL

​

 目录

背景

解决方案

总结

---

背景

对于查询数据列表的功能，需要分页已经查询总数。这里涉及两句SQL,一个是查询分页对应的数据，第二个是Count(*); 会导致部分重复代码和两次的数据库查询。

解决方案

Dapper有封装QueryMultipleAsync的异步方法支持执行多条SQL,来减少数据库查询次数。

使用方法

 public async Task<(IEnumerable<Log> list,int total)> GetListAsync()
    {
        string sql = @"SELECT sql_calc_found_rows id, mark1, mark2, mark3
                       FROM logs ORDER BY id ASC  LIMIT @Offset, @PageSize;
                       SELECT FOUND_ROWS()  ";
        DynamicParameters parameters = new DynamicParameters();
        parameters.Add("@Offset", 0);
        parameters.Add("@PageSize", 2);

        using var connection = _dapperContext.CreateConnection();
        using var multi = await connection.QueryMultipleAsync(sql, parameters);
        var list = await multi.ReadAsync<Log>();
        var total = await multi.ReadSingleAsync<int>();
        return (list, total);
    }

这里是查询MYSQL，使用了sql_calc_found_rows在第一个查询分页数据的SQL中，第二条是SELECT FOUND_ROWS()来获取Limit之外的行数。

使用QueryMultipleAsync方法返回的是一个GridReader对象。这个对象提供了一些方法读取数据，比如

Read, ReadAsync	返回可枚举的动态类型
Read<T>, ReadAsync<T>	返回 T 参数指定类型的枚举
ReadFirst, ReadFirstAsync	Returns the first row as a dynamic type
ReadFirst<T>, ReadFirstAsync<T>	将第一行作为动态类型返回
ReadFirstOrDefault, ReadFirstOrDefaultAsync	返回第一行作为 T 类型参数指定类型的实例
ReadFirstOrDefault<T>, ReadFirstOrDefaultAsync<T>	将第一行作为动态类型返回，如果未返回任何结果，则返回 null
ReadSingle, ReadSingleAsync	返回第一行作为 T 类型参数指定类型的实例，如果没有返回结果则返回 null
ReadSingle<T>, ReadSingleAsync<T>	在预期只返回一行时使用。 返回动态类型
ReadSingleOrDefault, ReadSingleOrDefaultAsync	在预期返回零行或一行时使用。 返回动态类型或 null

示例中使用ReadAsync读取数据，ReadSingleAsync读取count然后返回元组

var list = await multi.ReadAsync<Log>();
var total = await multi.ReadSingleAsync<int>();
return (list, total);

总结

通过使用Dapper的QueryMultipleAsync一次性查询多个结果，减少了与数据库服务器的请求次数。减少了代码量。

​