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) //自動同步實體結構到數據庫
.Build(); //請務必定義成 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)
內部設計
當插入大批量數據時县恕，內部采用分割分批執(zhí)行的邏輯進行驮俗。分割規(guī)則如下：
| 數量 | 參數量 | |
|---|---|---|
| MySql | 5000 | 3000 |
| PostgreSQL | 5000 | 3000 |
| SqlServer | 1000 | 2100 |
| Oracle | 500 | 999 |
| Sqlite | 5000 | 999 |
數據：為每批分割的大小主卫，如批量插入 10000 條數據暇屋，在 mysql 執(zhí)行時會分割為兩批蟀悦。
參數量：為每批分割的參數量大小仁期，如批量插入 10000 條數據计螺，每行需要使用 5 個參數化蕾各，在 mysql 執(zhí)行時會分割為每批 3000 / 5蕊温。
分割執(zhí)行后袱箱，當外部未提供事務時，內部自開事務义矛，實現(xiàn)插入完整性发笔。
FreeSql 適配了每一種數據類型參數化，和不參數化的使用凉翻。批量插入建議關閉參數化功能了讨，使用 .NonoParameter() 進行執(zhí)行（有關 NoneParameter 在后續(xù)文章介紹）。
性能參考
image
API
| 方法 | 返回值 | 參數 | 描述 |
|---|---|---|---|
| AppendData | <this> | T1 | IEnumerable<T1> | 追加準備插入的實體 |
| ToSql | string | 返回即將執(zhí)行的SQL語句 | |
| ExecuteAffrows | long | 執(zhí)行SQL語句，返回影響的行數 | |
| ExecuteIdentity | long | 執(zhí)行SQL語句前计，返回自增值 | |
| ExecuteInserted | List<T1> | 執(zhí)行SQL語句胞谭，返回插入后的記錄 | |
| ExecuteSqlBulkCopy | void | SqlServer 特有的功能，執(zhí)行 SqlBulkCopy 批量插入的封裝 | |
| ExecutePgCopy | void | PostgreSQL 特有的功能男杈，執(zhí)行 Copy 批量導入數據 |
系列文章導航
（六）批量插入數據
