FreeSql是一个支持.NET Core 2.1+、.NET Framework 4.0+ 以及 Xamarin的ORM(Object Relational Mapping)对象关系映射的组件
支持丰富的表达式函数及类型映射,但还是有不少开发者需要执行自定义SQL。
我一般会推荐他们使用List<T> list = fsql.Ado.Query<T>("select * from t1");
等类似的操作,IAdo下有大量的ADO.NET基础的调用操作。但开发者还想使用类似Page,Skip,OrderBy等方法。鉴于fsql可以生成SQL,可以将不同的SQL组合,实现更加复杂的功能。
引用包
dotnet add packages FreeSql
dotnet add packages FreeSql.Provider.Sqlite
.NET Core 单例 Startup.cs
public void ConfigureServices(IServiceCollection services)
{IFreeSql fsql = new FreeSql.FreeSqlBuilder().UseConnectionString(FreeSql.DataType.Sqlite, @"Data Source=db1.db").UseAutoSyncStructure(true) //自动同步实体结构到数据库,FreeSql不会扫描程序集,只有CRUD时才会生成表。.Build();services.AddSingleton<IFreeSql>(fsql);
}
可使用以下方式实现
WithSql 自定义SQL
定义实体类
public class TestClass{[Column(Name = "ID", IsPrimary = true)]public string No { get; set; }public int? Age { get; set; }public string Name { get; set; }[Column(Name = "BIRTH_DAY")]public DateTime? Birthday { get; set; }public decimal Point { get; set; }public Sex? Sex { get; set; }}public class TestClssDto{public string ID { get; set; }public int? Age { get; set; }}
不同的查询方式。
返回
DataTable
返回
List<Tuplue>
即List<(string,string)>
元组返回
List<object>
且能支持分页返回
List<TestClassDto>
且能支持分页
1.返回DataTable
DataTable dt1 = _fsql.Select<object>().WithSql("select * from TestClass ").ToDataTable("ID,Age");
SELECT ID,Age FROM(select * from TestClass ) a
2.返回DataTable
DataTable dt2 = _fsql.Select<object>().WithSql("select * from TestClass ").ToDataTable("*");
SELECT *
FROM ( select * from TestClass ) a
3.返回List<Tuplue>
即List<(string,string)>
元组
List<(string,string)> list1 = _fsql.Select<object>().WithSql("select * from TestClass ").ToList<(string, string)>("ID,Age");
SELECT ID, AgeFROM(select * from TestClass ) a
4.返回List<object>
var list2 = _fsql.Select<object>().WithSql("select * from TestClass ").ToList<object>("*");
SELECT *FROM(select * from TestClass ) a
5.返回List<object>
且能支持分页
var list3 = _fsql.Select<object>().WithSql("select * from TestClass ").WhereIf(true, "1=1").Page(1, 10).OrderBy("ID DESC").ToList<object>("ID,Age");
SELECT ID, AgeFROM(select * from TestClass ) aWHERE(1 = 1)ORDER BY ID DESClimit 0,10
6.返回List<TestClassDto>
且能支持分页
var list4 = _fsql.Select<object>().WithSql("select * from TestClass ").WhereIf(true, "1=1").Page(1, 10).OrderBy("ID DESC").ToList<TestClssDto>("ID,Age");
SELECT ID, AgeFROM(select * from TestClass ) aWHERE(1 = 1)ORDER BY ID DESClimit 0,10
通过 WithSql+ ToSQL实现 Union ALL 查询方法
1、二次 ISelect 查询:WithSql 使用多次,等于 UNION ALL 查询
WithSql 使用多次为 UNION ALL 查询,所以我们可以利用 ISelect.ToSql(FieldAliasOptions.AsProperty) 得到生成的 SQL,如下:
var sql1 = fsql.Select<Topic>().Where(a => a.Title.Contains("xxx")).ToSql();
var sql2 = fsql.Select<Topic>().Where(a => a.Title.Contains("yyy")).ToSql();fsql.Select<Topic>().WithSql(sql1).WithSql(sql2).ToList();
SELECT * from (SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime`
FROM ( SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime` FROM `tb_topic` a WHERE ((a.`Title`) LIKE '%xxx%') ) a) ftbUNION ALLSELECT * from (SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime`
FROM ( SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime` FROM `tb_topic` a WHERE ((a.`Title`) LIKE '%yyy%') ) a) ftb
2、跨分表查询:AsTable 相同实体多次操作,等于 Union ALL 查询
var sql = fsql.Select<User>().AsTable((type, oldname) => "table_1")a.AsTable((type, oldname) => "table_2").ToSql(a => a.Id);
select * from (SELECT a."Id" as1 FROM "table_1" a) ftb
UNION ALL
select * from (SELECT a."Id" as1 FROM "table_2" a) ftb
3、利用 ToSql 拼接新的 SQL,使用 IAdo 执行
var sql1 = fsql.Select<Topic>().Where(a => a.Id > 100 && a.Id < 200).ToSql(a => new { a.Id, a.Title }, FieldAliasOptions.AsProperty);
var sql2 = fsql.Select<Topic>().Where(a => a.Id > 1001 && a.Id < 1200).ToSql(a => new { a.Id, a.Title }, FieldAliasOptions.AsProperty);fsql.Ado.CommandFluent($"{sql1} UNION ALL {sql2}").ExecuteDataTable();
分页问题
Union All 之后 如果直接 分页会有一个问题。请看具体示例
多次WithSql+Page存在问题:每个WithSql内都有一个Page分页
var sql1 = fsql.Select<Topic>().Where(a => a.Title.Contains("xxx")).ToSql();
var sql2 = fsql.Select<Topic>().Where(a => a.Title.Contains("yyy")).ToSql();fsql.Select<Topic>().WithSql(sql1).WithSql(sql2).Page(1, 20).ToList();
SELECT * from (SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime`
FROM ( SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime` FROM `tb_topic` a WHERE ((a.`Title`) LIKE '%xxx%') ) a
limit 0,20) ftbUNION ALLSELECT * from (SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime`
FROM ( SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime` FROM `tb_topic` a WHERE ((a.`Title`) LIKE '%yyy%') ) a
limit 0,20) ftb
多个sql union all使用withsql,直接Page分页,会导致每个子表都生效,子表都生成分页。
WithSql 可以和 AsTable 实现分表的功能。
分表跨表查询的时候,分页是要向每个子表(即每个WithSql中的SQL分页)都生效。
解决方案
多次withsql,如需分页,需要按下面的二步操作
第一步:通过witsql,将二个sql组成一个sql。
var sql = fsql.Select<Topic>().WithSql("SELECT * FROM tb_topic where id > 11").WithSql("SELECT * FROM tb_topic where id < 10").ToSql("*")
如上生成的UOION ALL的sql
SELECT * from (SELECT * FROM ( SELECT * FROM tb_topic where id > 11 ) a) ftbUNION ALLSELECT * from (SELECT * FROM ( SELECT * FROM tb_topic where id < 10 ) a) ftb
第二步:之后 调用Page则是通过Union ALL后的结果上分页
var sql2 = g.mysql.Select<Topic>().WithSql(sql).Page(2, 10).ToSql();
SELECT a.`Id`, a.`Clicks`, a.`TypeGuid`, a.`Title`, a.`CreateTime`
FROM ( SELECT * from (SELECT *FROM ( SELECT * FROM tb_topic where id > 11 ) a) ftbUNION ALLSELECT * from (SELECT *FROM ( SELECT * FROM tb_topic where id < 10 ) a) ftb ) a
limit 10,10
更多
参考官网http://freesql.net/guide/getting-started.html
GitHubhttps://github.com/dotnetcore/FreeSql/