【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对象。这个对象提供了一些方法读取数据,比如

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

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

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

总结

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