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

介紹

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的資料請關注碩編程其它相關文章！