以下文章来源于全栈程序员园地 ，作者小袁同学
项目介绍
SqlSugar是一个针对.NET平台设计的ORM框架，以其快速、简单、易用著称，并支持多种数据库，包括国内外主流数据库和国产数据库。
开箱即用，MIT License开源免费。
开源地址：https://gitee.com/dotnetchina/SqlSugar
在线文档：https://www.donet5.com/Home/Doc?typeId=1180
ORM的作用
ORM通过提供一套面向对象的方式来操作数据库，简化了数据库操作的复杂性，提高了开发效率和代码质量，是现代软件开发中不可或缺的工具之一。
功能介绍
真正可以实现零SQL的ORM 建表、索引和CRUD全部支持。
支持 .NET 百万级大数据写入、更新、分表和拥有几十亿查询统计成熟解决方案。
支持 SAAS 完整应用 ：跨库查询 、审计、租户分库 、租户分表 和 租户数据隔离。
支持低代码+工作流 （动态建类 、动态建表、无实体多库兼容CRUD 、 JSON TO SQL 、自定义XML等）。
支持ValueObject、鉴别器、仓储、UnitOfWork、DbContext、AOP 。
支持 DbFirst、CodeFirst和WebFirst 3种模式开发。
简单易用、功能齐全、高性能、轻量级、文档齐全
完美支持AOT：多种数据库。
数据库支持
原生模式
SqlSugarClient 每次请求new一个新对象，db禁止跨上下文使用，IOC建议用Scope或者瞬发注入
using SqlSugar;//创建数据库对象 (用法和EF Dappper一样通过new保证线程安全)
SqlSugarClient Db = new SqlSugarClient(new ConnectionConfig()
{ConnectionString = "datasource=demo.db",DbType = DbType.Sqlite,IsAutoCloseConnection = true
},
db => {db.Aop.OnLogExecuting = (sql, pars) =>{//获取原生SQL推荐 5.1.4.63 性能OKConsole.WriteLine(UtilMethods.GetNativeSql(sql, pars));//获取无参数化SQL 对性能有影响，特别大的SQL参数多的，调试使用//Console.WriteLine(UtilMethods.GetSqlString(DbType.SqlServer,sql,pars))};//注意多租户 有几个设置几个//db.GetConnection(i).Aop});//建库
Db.DbMaintenance.CreateDatabase();//达梦和Oracle不支持建库//建表（看文档迁移）
Db.CodeFirst.InitTables<Student>(); //所有库都支持 //查询表的所有
var list = Db.Queryable<Student>().ToList();//插入
Db.Insertable(new Student() { SchoolId = 1, Name = "jack" }).ExecuteCommand();//更新
Db.Updateable(new Student() { Id = 1, SchoolId = 2, Name = "jack2" }).ExecuteCommand();//删除
Db.Deleteable<Student>().Where(it => it.Id == 1).ExecuteCommand();//实体与数据库结构一样
public class Student
{//数据是自增需要加上IsIdentity //数据库是主键需要加上IsPrimaryKey //注意：要完全和数据库一致2个属性[SugarColumn(IsPrimaryKey = true, IsIdentity = true)]public int Id { get; set; }public int? SchoolId { get; set; }public string? Name { get; set; }
}
单例模式
SqlSugarScope 请使用单例模式，配置参数有2种周期:
1、全局生效
2、当前上下文生效
using SqlSugar;//建库
SqlSugarHelper.Db.DbMaintenance.CreateDatabase();//达梦和Oracle不支持建库//建表 （看文档迁移）
SqlSugarHelper.Db.CodeFirst.InitTables<Student>(); //所有库都支持//查询表的所有
var list = SqlSugarHelper.Db.Queryable<Student>().ToList();//插入
SqlSugarHelper.Db.Insertable(new Student() { SchoolId = 1, Name = "jack" }).ExecuteCommand();//更新
SqlSugarHelper.Db.Updateable(new Student() { Id = 1, SchoolId = 2, Name = "jack2" }).ExecuteCommand();//删除
SqlSugarHelper.Db.Deleteable<Student>().Where(it => it.Id == 1).ExecuteCommand();public class SqlSugarHelper //不能是泛型类
{//多库情况下使用说明：//如果是固定多库可以传 new SqlSugarScope(List<ConnectionConfig>,db=>{}) 文档：多租户//如果是不固定多库 可以看文档Saas分库//用单例模式public static SqlSugarScope Db = new SqlSugarScope(new ConnectionConfig(){ConnectionString = "datasource=demo.db",//连接符字串DbType = DbType.Sqlite,//数据库类型IsAutoCloseConnection = true //不设成true要手动close},db => {//(A)全局生效配置点，一般AOP和程序启动的配置扔这里面 ，所有上下文生效//调试SQL事件，可以删掉db.Aop.OnLogExecuting = (sql, pars) =>{ //获取原生SQL推荐 5.1.4.63 性能OKConsole.WriteLine(UtilMethods.GetNativeSql(sql,pars));//获取无参数化SQL 对性能有影响，特别大的SQL参数多的，调试使用//Console.WriteLine(UtilMethods.GetSqlString(DbType.SqlServer,sql,pars))};//多个配置就写下面//db.Ado.IsDisableMasterSlaveSeparation=true;//注意多租户 有几个设置几个//db.GetConnection(i).Aop});
}//实体与数据库结构一样
public class Student
{//数据是自增需要加上IsIdentity //数据库是主键需要加上IsPrimaryKey //注意：要完全和数据库一致2个属性[SugarColumn(IsPrimaryKey = true, IsIdentity = true)]public int Id { get; set; }public int? SchoolId { get; set; }public string? Name { get; set; }
}
