ShadowSql之.net sql拼写神器

我正在开发的一个.net sql拼写工具(SqlBuilder),也可以算是ORM,命名为ShadowSql

本工具的作用就是帮码农拼写sql,对标开源项目SqlKata。

在项目里面直接拼写sql很容易出错,是件很Low的事情,所以我们需要ORM工具。

但是有些ORM很重,很担心造成性能问题,这就是开发本工具的出发点.

本工具很小、不依赖第三方包,不使用反射,应该支持AOT原生编译,不过我还没测试。

本工具最大的特点就是性能好,省内存,拼接sql从头到尾只使用一个StringBuilder。

跨平台、可扩展、支持多种数据库,可以自定义数据库方言,支持net7.0;net8.0;net9.0;netstandard2.0;netstandard2.1。

本工具最适合搭配Dapper使用,所以附带了一个Dapper扩展。当然直接搭配ado.net也是可以的。

sql操作用的最多也是最复杂的就是查询,本工具包含两套查询模式:sql模式和逻辑模式。

一、先介绍sql查询模式

1、支持按原生sql进行查询,示例如下:

        var query = db.From("Users")             .ToSqlQuery()             .Where("Id=@Id", "Status=@Status");

sql: SELECT * FROM [Users] WHERE Id=@Id AND Status=@Status

2、支持按逻辑查询

        var query = new UserTable()             .ToSqlQuery()             .Where(Id.EqualValue(100));

sql: SELECT * FROM [Users] WHERE [Id]=100

3、支持GroupBy

        var table = db.From("Users");         var groupBy = table.ToSqlQuery()             .ColumnEqualValue("Age", 20)             .GroupBy("CityId")             .Having(g => g.Aggregate("MAX", "Level").GreaterValue(9));

sql: SELECT * FROM [Users] WHERE [Age]=20 GROUP BY [CityId] HAVING MAX([Level])>9

4、支持联表

        var employees = db.From("Employees");         var departments = db.From("Departments");          var joinOn = employees.SqlJoin(departments)             .On(static (t1, t2) => t1.Field("DepartmentId").Equal(t2.Field("Id")));         var joinTable = joinOn.Root             .Where(join => join.From("t2").Field("Manager").EqualValue("CEO"));

sql: SELECT * FROM [Employees] AS t1 INNER JOIN [Departments] AS t2 ON t1.[DepartmentId]=t2.[Id] WHERE t2.[Manager]='CEO'

二、逻辑模式

以上功能逻辑模式大多都支持,逻辑模式是按And、Or来查询的。没有where、having、on等关键字

逻辑模式不支持按原生sql查询,当然封装为逻辑对象就可以了,但不推荐这么做。

所谓逻辑就是与、或、非运算。

Sql模式也支持逻辑对象,从这个层面上说sql模式功能更全,sql模式查询对象就是包含一个复合逻辑对象+Sql查询对象。

逻辑模式一般执行速度更快、内存消耗更少。

1、单表查询

        var query = db.From("Users")             .ToQuery()             .And(_id.Equal())             .And(_status.Equal("Status"));

        var query = db.From("Users")             .ToOrQuery()             .Or(_id.Equal())             .Or(_status.Equal("Status"));

SELECT * FROM [Users] WHERE [Id]=@Id AND [Status]=@Status

SELECT * FROM [Users] WHERE [Id]=@Id OR [Status]=@Status

2、GroupBy

        var groupBy = table.ToQuery()             .And(Age.EqualValue(20))             .GroupBy("CityId")             .And(Level.Max().GreaterValue(9));

sql: SELECT * FROM [Users] WHERE [Age]=20 GROUP BY [CityId] HAVING MAX([Level])>9

3、联表

        CommentTable c = new("c");         PostTable p = new("p");         var joinOn = c.Join(p)             .And(c.PostId.Equal(p.Id));         var query = joinOn.Root             .And(c.Pick.Equal())             .And(p.Author.Equal())

sql: SELECT * FROM [Comments] AS c INNER JOIN [Posts] AS p ON c.[PostId]=p.[Id] where c.[Pick]=@Pick AND p.[Author]=@Author

篇幅有限,还有很多功能没法在这里一一列举,欢迎大家去探索,抽出时间我也会再发新文章来做更详细的介绍。

三、两种模式与SqlKata对比速度都更快,消耗内存也更少

ShadowSql之.net sql拼写神器

 更多信息可以到github上查询,或下载代码自己测试一下

四、源码托管在github上

仓库地址: https://github.com/donetsoftwork/Shadow

如果大家喜欢请动动您发财的小手手帮忙点一下Star。

有什么建议也可以反馈给我,该项目还在开发中,还可能会增加更多有趣的功能。

而且我还计划为这个工具再开发一个精简版本,以求更好的性能。

 

发表评论

您必须 [ 登录 ] 才能发表留言!

相关文章