介紹
SqlSugar是一款 老牌 .NET 開源ORM框架，由果糖大資料科技團隊維護和更新 ，Github star數僅次於EF 和 Dapper
優點： 簡單易用、功能齊全、高效能、輕量級、服務齊全、有專業技術支援一天18小時服務
支援資料庫：MySql、SqlServer、Sqlite、Oracle 、 postgresql、達夢、人大金倉
新功能介紹
最新穩定版本5.0.2.8 ，釋出後1個月時間NUGET下載量達到5000的版本，使用者使用也相當滿意
而在穩定版本的基礎上又布了5.0.2.9版本
加入3大新功能
1. 配置查詢
解決了大量字典表和簡單就為取一個name 就要寫聯表的問題，讓單表查詢解決一切
2.多租戶+倉儲+自動分配
3.行轉列
1、配置查詢
解決了大量字典表和簡單就為取一個name 就要寫聯表的問題，讓單表查詢解決一切
字典表我相信大家都全用到，他們可以方便的儲存性別、學歷、崗位等 一串資料 並進行TypeId進行區分
1.1 建立測試資料
建立一個字典實體
public class DataDictionary
{
public string Code { get; set; }
public string Name { get; set; }
public string Type { get; set; }
}
建立字典表並向裡面插入測試資料
var db = GetInstance();
List<DataDictionary> datas = new List<DataDictionary>();
datas.Add(new DataDictionary() { Code="1", Name="男",Type="sex" });
datas.Add(new DataDictionary() { Code = "2", Name = "女", Type = "sex" });
datas.Add(new DataDictionary() { Code = "1", Name = "南通市", Type = "city" });
datas.Add(new DataDictionary() { Code = "2", Name = "蘇州市", Type = "city" });
datas.Add(new DataDictionary() { Code = "1", Name = "江蘇省", Type = "province" });
datas.Add(new DataDictionary() { Code = "2", Name = "湖南省", Type = "province" });
db.CodeFirst.InitTables<DataDictionary>();
db.Insertable(datas);
在建一個Person表
public class Person
{
//資料庫欄位
[SqlSugar.SugarColumn(IsPrimaryKey =true,IsIdentity =true)]
public int Id { get; set; }
public string Name { get; set; }
public int SexId { get; set; }
public int CityId { get; set; }
public int ProviceId { get; set; }
//非資料庫欄位
[SqlSugar.SugarColumn(IsIgnore =true)]
public string SexName { get; set; }
[SqlSugar.SugarColumn(IsIgnore = true)]
public string CityName { get; set; }
[SqlSugar.SugarColumn(IsIgnore = true)]
public string ProviceName { get; set; }
}
1.2 傳統字典聯表實現缺點
如果我們要將Person中的非資料字典查詢出來那麼我們就需要寫有2種實現方式
1.連表或者子查詢 （缺點 寫起來很浪費時間）
2.將字典存到記憶體，通過記憶體賦值 （缺點 字典表超過1000條以上效能很差 ，並且不能排序，或者LIKE）
下面介紹通過SqlSugar的配置查詢解決上2面個難題
1.3 配置表簡化字典聯表
配置字典表
if (!db.ConfigQuery.Any())
{
var types= db.Queryable<DataDictionary>().Select(it => it.Type).Distinct().ToList();
foreach (var type in types)
{
db.ConfigQuery.SetTable<DataDictionary>(it => it.Code, it => it.Name, type, it => it.Type == type);
}
//如果其中Code都是唯一值可以按 1.4中的用法使用迴圈都不要
}
配置完我們查詢就會很方便了
var res=db.Queryable<Person>().Select(it => new Person()
{
Id=it.Id.SelectAll(),
SexName=it.SexId.GetConfigValue<DataDictionary>("sex"),
ProviceName = it.SexId.GetConfigValue<DataDictionary>("province"),
CityName = it.SexId.GetConfigValue<DataDictionary>("city"),
}).ToList();
//也支援支援寫在Where或者Orderby
1.4 簡單聯表查詢也可以配置
db.ConfigQuery.SetTable<Order>(it => it.Id, it => it.Name);//配置Order
var list3 = db.Queryable<OrderItem>().Select(it => new OrderItem { ItemId = it.ItemId.SelectAll(), OrderName = it.OrderId.GetConfigValue<Order>() //查詢的時候直接用 }).ToList();
總結：配置表查詢的方式可以大大降低重複聯表問題，並且配置好後基本就不要寫JOIN了
2、多租戶+倉儲+自動分配
SqlSugar多租戶是通過ConfigId進行識別連線哪個庫，新版本新增了實體配置ConfigId
[TenantAttribute("1")]
public class C1Table
{
public string Id { get; set; }
}
[TenantAttribute("2")]
public class C2Table
{
public string Id { get; set; }
}
下面我們倉儲就可以通過實體配置自動識別是連線哪個庫
public class Repository<T> : SimpleClient<T> where T : class, new()
{
public Repository(ISqlSugarClient context = null) : base(context)//注意這裡要有預設值等於null
{
if (context == null)
{
var db = new SqlSugarClient(new List<ConnectionConfig> {
new ConnectionConfig()
{
ConfigId="1",
DbType = SqlSugar.DbType.SqlServer,
IsAutoCloseConnection = true,
ConnectionString = Config.ConnectionString
},
new ConnectionConfig()
{
ConfigId="2",
DbType = SqlSugar.DbType.SqlServer,
IsAutoCloseConnection = true,
ConnectionString = Config.ConnectionString2
}
});
base.Context = db;
var configId = typeof(T).GetCustomAttribute<TenantAttribute>().configId;
db.ChangeDatabase(configId);
}
}
/// <summary>
/// 擴充套件方法，自帶方法不能滿足的時候可以新增新方法
/// </summary>
/// <returns></returns>
public List<T> CommQuery(string sql)
{
//base.Context.Queryable<T>().ToList();可以拿到SqlSugarClient 做複雜操作
return base.Context.Queryable<T>().Where(sql).ToList();
}
}
新版本還新增了切換倉儲功能
public class C1Service : Repository<C1Table>
{
public void Test()
{
base.AsTenant().BeginTran();
base.GetList(); //呼叫內部倉儲方法
base.ChangeRepository<Repository<C2Table>>().GetList();//呼叫外部倉儲
base.AsTenant().CommitTran();
}
}
3、行列互轉功能
第一個引數 列名、第二個引數 頭行名、第三個引數 值
var test06 = db.Queryable<Order>()
.ToPivotTable(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));//返回Datatable
var test07 = db.Queryable<Order>()
.ToPivotList(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));//返回List<dynamic>
var test08 = db.Queryable<Order>()
.ToPivotJson(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));//返回Json