SqlSugar ORM 5.X 官网 、文档、教程 - SqlSugar 5x - .NET果糖网 (donet5.com)

参考文档：

基于SqlSugar的数据库访问处理的封装，支持多数据库并使之适应于实际业务开发中_倾听铃的声的博客-CSDN博客_sqlsugar 多库

C# 数据操作系列 - 14 深入探索SqlSugar_chinaherolts2008的博客-CSDN博客

SqlSugar轻量ORM - 張暁磊 - 博客园 (cnblogs.com)

一.配置SqlSuagr连接到SqlServer数据库

1.创建一个ConnectionConfig

(1)主要函数

public static ConnectionConfig BuildConnConfig(dynamic configId, DbType dbType, string connectionString) { return new ConnectionConfig() { ConfigId = configId, DbType = dbType, //数据库类型 ConnectionString = connectionString,//连接字符串 IsAutoCloseConnection = true, //自动释放和关闭数据库连接，如果有事务事务结束时关闭，否则每次操作后关闭//是否自动释放数据库(默认false)，设为true我们不需要close或者Using的操作，比较推荐 MoreSettings = new ConnMoreSettings()//更多设置 { IsWithNoLockQuery = true //为true表示可以自动删除二级缓存 }, //InitKeyType = InitKeyType.Attribute,//默认就是这个，从实体特性中读取主键自增列信息，初始化主键和自增列信息到ORM的方式 AopEvents = new AopEvents //调试SQL事件，可以删掉 { OnLogExecuting = (sql, p) => { p.ToDictionary(it => it.ParameterName, it => it.Value); System.Diagnostics.Trace.WriteLine(sql); System.Diagnostics.Trace.WriteLine(string.Join(",", p?.Select(it => it.ParameterName + ":" + it.Value))); } } }; }

（2）传参

在一个json文件中配置好了数据库的参数

?到时候直接读取json，并转换成一个实体类的对象

if (!db.Enabled)//判断这个连接是否有用 { return; } //db是那个实体类的对象 DbType dbType = (DbType)System.Enum.Parse(typeof(DbType), db.DbType.ToString()); SqlConnectionStringBuilder sqlcsb = new SqlConnectionStringBuilder(db.ConnectionString); ConnectionConfig dbConfig = DbContext.BuildConnConfig(db.ConfigId, dbType, sqlcsb.ToString());

2.初始化数据库连接

public static void SetupDBConnectionConfig(List<ConnectionConfig> connectionConfigs) { if (db != null) { db.CommitTran();//存自最后一个BeginTrans方法调用以来的所有更改，并结束当前事务。 db.Dispose();//回滚任何挂起的事务,清空了connectionString,下次用在new connection，不会报错 return; } //因为SqlSugarScope继承成IDisposable，如果不是全局使用，可以使用using自动释放资源,然后在using的大括号内进行配置 db = new SqlSugarScope(connectionConfigs); //SetDbFirst(); //SetCodeFirst(); }

3.DbFirst

public static void SetDbFirst() { //根据数据库生成对应的类，其他方法看官网 db.DbFirst.IsCreateAttribute().CreateClassFile(@"D:\0.data\VSCode\ReportGeneration\Models\1", "Models");//第二个参数可以缺省 //加 @表示无视转义符的存在。比如@”\n" 不是表示换行，而是表示\和n，否则要\\ //采用Dbfirst时，建议先生成一个类库(需要添加SqlSugar的包)，然后生成路径设为这个类库下的一个新的文件夹 //如果文件没有显示（和这个类库的csproj文件有关，可以打开查看只有里面有的文件名才能显示） //可以点显示所有文件查看是否存在（资源管理器刷新右边第2个按钮） //如果存在且没有显示，则在桌面打开文件夹拖进左侧的类库下，没有的类删掉 }

4.?CodeFirst

public static void SetCodeFirst() { //首先要引用上面创建的数据库类库 Assembly assembly = Assembly.LoadFrom("Models.dll");//使用反射加载程序集并执行方法 IEnumerable<Type> typelist = assembly.GetTypes().Where(c => c.Namespace == "Models");//获取此程序集中定义的类型，且命名空间=Models的，where可以不用 bool Backup = false;//是否备份 db.DbMaintenance.CreateDatabase(); //创建一个数据库出来 if (Backup) { db.CodeFirst.BackupTable().InitTables(typelist.ToArray()); } else { db.CodeFirst.InitTables(typelist.ToArray()); } //在下面可以初始化种子数据 }

?7.Model类的属性特性

namespace TemplateNode.Models { [SugarTable("BaseNode2")]//当类名和表名不一样时可以设置表别名 指定表明 public class BaseNode { [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]//IsPrimaryKey是主键，IsIdentity是自增 public int Id { get; set; } [SugarColumn(ColumnName = "Name2", ColumnDescription = "注释")] //ColumnName：属性名和表中的列名不一样 设置列名，ColumnDescription：设置表的备注 public string Name { get; set; } [SugarColumn(IsIgnore = true)]//IsIgnore表示ORM不处理该列 public string Description { get; set; } [SugarColumn(IsOnlyIgnoreInsert = true, IsNullable = true, Length=10)] //IsOnlyIgnoreInsert：插入操作不处理该列，IsNullable：允许为NULL,Length不指定默认为50 public string Description2 { get; set; } [SugarColumn(IsOnlyIgnoreUpdate = true,ColumnDataType = "Nvarchar(256)")] //IsOnlyIgnoreUpdate：更新操作不处理该列，ColumnDataType/自定格式的情况,length不要设置 public string Description3 { get; set; } } }

还可以自定义特性，更多参考连接配置实体 - SqlSugar 5x - .NET果糖网 (donet5.com)?

Code First 代码优先,数据迁移 - SqlSugar 5x - .NET果糖网 (donet5.com)?

6. 实现数据库读写分离

总结:不要盲目使用读写分离 ,在考虑读写分离之前应该先考虑缓存 例如( redius)? ?和大数据表的水平切割

（1）首先SqlServer那里需要建立主库和分库，参考下面连接中的内容

SqlServer中配置读写分离_木白星枝的博客-CSDN博客

（2）需要重新配置ConnectionConfig

public static void SetSeparation() { String connectionString = "Data Source=42.12.6.03,1433;Initial Catalog=d_test;User ID=sa;Password=48"; List<SlaveConnectionConfig> slaveConnectionConfigs = new List<SlaveConnectionConfig>() { new SlaveConnectionConfig() { HitRate=10, ConnectionString="Data Source=42.12.6.03,1433;Initial Catalog=d1;User ID=sa;Password=48" }, new SlaveConnectionConfig() { HitRate=10, //概率 ConnectionString="Data Source=42.12.6.03,1433;Initial Catalog=d2;User ID=sa;Password=48" } }; ConnectionConfig dbConfig =BuildConnConfig2(null, DbType.SqlServer, connectionString, slaveConnectionConfigs); } public static ConnectionConfig BuildConnConfig2(dynamic configId, DbType dbType, string connectionString,List<SlaveConnectionConfig> slaveConnectionConfigs) { return new ConnectionConfig() { ConfigId = configId, //可有可无，指定为1吧，不赋值也可以 DbType = dbType, //数据库类型 ConnectionString = connectionString,//主库的数据库连接 SlaveConnectionConfigs=slaveConnectionConfigs,//从库的数据库连接 IsAutoCloseConnection = true, //(默认false)是否自动释放数据库，设为true我们不需要close或者Using的操作，比较推荐 MoreSettings = new ConnMoreSettings() { IsWithNoLockQuery = true//看这里 //为true表示可以自动删除二级缓存 }, //InitKeyType = InitKeyType.Attribute,//默认就是这个，从实体特性中读取主键自增列信息，初始化主键和自增列信息到ORM的方式 AopEvents = new AopEvents //调试SQL事件，可以删掉 { OnLogExecuting = (sql, p) => { p.ToDictionary(it => it.ParameterName, it => it.Value); System.Diagnostics.Trace.WriteLine(sql); System.Diagnostics.Trace.WriteLine(string.Join(",", p?.Select(it => it.ParameterName + ":" + it.Value))); } } }; }

（3）修改主库，从库会跟着改，修改从库，主库不变，修改主库后，数据同步到从库有延迟。

同步有延迟，要么业务允许延迟，要么直接查询主库

直接查询主库需要在查询前进行设置

//主要是针对及时性要求比较高的 db.Ado.IsDisableMasterSlaveSeparation = true; //直接基于主库进行查询

?应该监控文件更新，手动刷新不太好?

?6.实现分表

（1）分表使用场景

?<1>.NET可扩展架构设计，比如一个ERP用5年不卡，到了10年就卡了因为数据太多了，这个时候很多人都是备份然后清空数据

<2>.NET?数据量太多 ，每天都有几十上百万的数据进入库，如果不分表后面查询将会非常缓慢

<3>.NET性能瓶颈 ，数据库现有数据超过1个亿，很多情况下索引会莫名失效，性能大大下降

(2)内置分表使用

.NET 自带分表支持按年、按季、按月、按周、按日进行分表?

根据插入的数据自动分表，在数据库下自动创建分表，查询的时候不需要考虑具体几个分表。

?具体操作参看官网。

---

1.本站遵循行业规范，任何转载的稿件都会明确标注作者和来源；2.本站的原创文章，会注明原创字样,如未注明都非原创，如有侵权请联系删除！；3.作者投稿可能会经我们编辑修改或补充；4.本站不提供任何储存功能只提供收集或者投稿人的网盘链接。