.net數據庫操作框架SqlSugar的簡單入門

Posted on by

介紹

SqlSugar是一款 老牌 .NET數據庫操作框架，由果糖大數據科技團隊維護和更新 ，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).ExecuteCommand();//這樣就能把數據插進數據庫瞭<br>

在建一個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 ProvinceId { 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"),
                 ProvinceName = it.ProvinceId.GetConfigValue<DataDictionary>("province"),
                 CityName = it.CityId.GetConfigValue<DataDictionary>("city"),
   }).ToList();
 
//也支持支持寫在Where或者Orderby　

1.4 簡單聯表查詢也可以配置

db.ConfigQuery.SetTable<Order>(it => it.Id, it => it.Name);//配置Order<br>
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><br>
var test08 = db.Queryable<Order>()
            .ToPivotJson(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));//返回Json

.NET數據庫框架源碼  

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

以上就是.net數據庫操作框架SqlSugar的簡單入門的詳細內容，更多關於.net數據庫操作框架SqlSugar的資料請關註WalkonNet其它相關文章！

推薦閱讀：