我正在开发的一个.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对比速度都更快,消耗内存也更少
更多信息可以到github上查询,或下载代码自己测试一下
四、源码托管在github上
仓库地址: https://github.com/donetsoftwork/Shadow
如果大家喜欢请动动您发财的小手手帮忙点一下Star。
有什么建议也可以反馈给我,该项目还在开发中,还可能会增加更多有趣的功能。
而且我还计划为这个工具再开发一个精简版本,以求更好的性能。