ORM 創新解放勞動力 -SqlSugar 新功能介紹-有解無憂

介紹

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);
                }
   }

配置完我們查詢就會很方便了

   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

原始碼下載： https://github.com/donet5/SqlSugar

官網地址: https://www.donet5.com/Home/Doc

轉載請註明出處，本文鏈接：https://www.uj5u.com/net/280142.html

標籤：.NET技术

上一篇：C#中的JSON序列化方法

下一篇：ASP.NET CORE使用WebUploader對大檔案分片上傳，并通過ASP.NET CORE SignalR實時反饋后臺處理進度給前端展示