FreeSql 以 MIT 開源協(xié)議托管于 github：https://github.com/2881099/FreeSql

var connstr = "Data Source=127.0.0.1;Port=3306;User ID=root;Password=root;" + 
    "Initial Catalog=cccddd;Charset=utf8;SslMode=none;Max pool size=10";

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.MySql, connstr)
    .UseAutoSyncStructure(true) //自動(dòng)同步實(shí)體結(jié)構(gòu)到數(shù)據(jù)庫(kù)
    .Build(); //請(qǐng)務(wù)必定義成 Singleton 單例模式

[Table(Name = "tb_topic")]
class Topic {
    [Column(IsIdentity = true, IsPrimary = true)]
    public int Id { get; set; }
    public int Clicks { get; set; }
    public string Title { get; set; }
    public DateTime CreateTime { get; set; }
}

批量插入

var items = new List<Topic>();
for (var a = 0; a < 10; a++) items.Add(new Topic { Id = a + 1, Title = $"newtitle{a}", Clicks = a * 100 });

fsql.Insert(items).ExecuteAffrows();

執(zhí)行SQL如下：

INSERT INTO `tb_topic`(`Clicks`, `Title`, `CreateTime`) 
VALUES(?Clicks0, ?Title0, ?CreateTime0), 
(?Clicks1, ?Title1, ?CreateTime1), 
(?Clicks2, ?Title2, ?CreateTime2), 
(?Clicks3, ?Title3, ?CreateTime3), 
(?Clicks4, ?Title4, ?CreateTime4), 
(?Clicks5, ?Title5, ?CreateTime5), 
(?Clicks6, ?Title6, ?CreateTime6), 
(?Clicks7, ?Title7, ?CreateTime7), 
(?Clicks8, ?Title8, ?CreateTime8), 
(?Clicks9, ?Title9, ?CreateTime9)

內(nèi)部設(shè)計(jì)

當(dāng)插入大批量數(shù)據(jù)時(shí)，內(nèi)部采用分割分批執(zhí)行的邏輯進(jìn)行。分割規(guī)則如下：

數(shù)據(jù)：為每批分割的大小，如批量插入 10000 條數(shù)據(jù)，在 mysql 執(zhí)行時(shí)會(huì)分割為兩批。
參數(shù)量：為每批分割的參數(shù)量大小，如批量插入 10000 條數(shù)據(jù)，每行需要使用 5 個(gè)參數(shù)化，在 mysql 執(zhí)行時(shí)會(huì)分割為每批 3000 / 5。

分割執(zhí)行后，當(dāng)外部未提供事務(wù)時(shí)，內(nèi)部自開事務(wù)，實(shí)現(xiàn)插入完整性。

FreeSql 適配了每一種數(shù)據(jù)類型參數(shù)化，和不參數(shù)化的使用。批量插入建議關(guān)閉參數(shù)化功能，使用 .NonoParameter() 進(jìn)行執(zhí)行（有關(guān) NoneParameter 在后續(xù)文章介紹）。

性能參考

image

API

系列文章導(dǎo)航

• （一）入門

• （二）自動(dòng)遷移實(shí)體

• （三）實(shí)體特性

• （四）實(shí)體特性 Fluent Api

• （五）插入數(shù)據(jù)

• （六）批量插入數(shù)據(jù)

• （七）插入數(shù)據(jù)時(shí)忽略列

• （八）插入數(shù)據(jù)時(shí)指定列

• （九）刪除數(shù)據(jù)

• （十）更新數(shù)據(jù)

• （十一）更新數(shù)據(jù) Where

• （十二）更新數(shù)據(jù)時(shí)指定列

• （十三）更新數(shù)據(jù)時(shí)忽略列

• （十四）批量更新數(shù)據(jù)

• （十五）查詢數(shù)據(jù)

• （十六）分頁(yè)查詢

• （十七）聯(lián)表查詢

• （十八）導(dǎo)航屬性

• （十九）多表查詢

• （二十）多表查詢 WhereCascade

• （二十一）查詢返回?cái)?shù)據(jù)

• （二十二）Dto 映射查詢

• （二十三）分組、聚合

• （二十四）Linq To Sql 語(yǔ)法使用介紹

• （二十五）延時(shí)加載

• （二十六）貪婪加載 Include、IncludeMany、Dto、ToList

• （二十七）將已寫好的 SQL 語(yǔ)句，與實(shí)體類映射進(jìn)行二次查詢

• （二十八）事務(wù)

• （二十九）Lambda 表達(dá)式

• （三十）讀寫分離

• （三十一）分區(qū)分表

• （三十二）Aop

• （三十三）CodeFirst 類型映射

• （三十四）CodeFirst 遷移說明

• （三十五）CodeFirst 自定義特性