高性能数据导入方案&表过滤器&一对多支持筛选- .NET SqlSugar ORM

一、数据导入有哪些难题

1、数据分类

你需要将插入、更新、忽略不计、错误数据等进么分类汇总，最后返回给客户，如果没有很好的设计想把这些操作一步到位非常的难

2、高性能

对于插入或者更新肯定不能单纯的插入或者更新，一定要批量操作，或者用到blukcopy操作

3、数据验证

对于错误数据要进行组装，并返回客户，让客户知道哪些字段哪个数据出现错误

二、使用 Storageable 解决难题

我们可以使用SqlSugar ORM中的 Storageable功能来解决上面的几大难题，SqlSugar 作为老牌ORM框架一直在创新和更新

1、入门示例

如何用Storageable实现简单的插入或者更新

例题1：导入一个List ，当id等0插入， id>0执行更新（id是主键）

List<UinitBlukTable> list2 = new List<UinitBlukTable>();
list2.Add(new UinitBlukTable() { Id = 1, Name = "a", Create = DateTime.Now });
list2.Add(new UinitBlukTable() { Id = 2, Name = "a", Create = DateTime.Now });
list2.Add(new UinitBlukTable() { Id = 0, Name = "a", Create = DateTime.Now });
 
var x = Db.Storageable(list2)
.SplitUpdate(it => it.Item.Id > 0)
.SplitInsert(it => it.Item.Id == 0).ToStorage();
x.AsInsertable.ExecuteCommand();
x.AsUpdateable.ExecuteCommand();

例题2：导入一个LIST,当Id存在数据执行更新，否则执行插入

var x = Db.Storageable(list2)
                            .SplitUpdate(it => it.Any(y=>y.Id==it.Item.Id))//数据库存在更新
                            .SplitInsert(it => true ).ToStorage();//其余插入
                            x.AsInsertable.ExecuteCommand(); //也可以使用blukcopy  参考SqlSugar blukcopy用法
                            x.AsUpdateable.ExecuteCommand();

如果实体没有主键我们可以用

var x = Db.Storageable(list2)
                            .SplitUpdate(it => it.Any(y=>y.Id==it.Item.Id))
                            .SplitInsert(it => it.NotAny(y => y.Id == it.Item.Id))
                            .WhereColumns(it=>it.Id).ToStorage(); //以id作为数据库唯一列，当然支持多个 new {it.id,it.name}

2.数据验证和统计

准备4条测试数据

List<UinitBlukTable> list2 = new List<UinitBlukTable>();
list2.Add(new UinitBlukTable() { Id = 1, Name = "a", Create = DateTime.Now });
list2.Add(new UinitBlukTable() { Id = 2, Name = "a", Create = DateTime.Now });
list2.Add(new UinitBlukTable() { Id = 3, Name = "a", Create = DateTime.Now.AddYears(-2) });
list2.Add(new UinitBlukTable() { Id = 4, Name ="", Create = DateTime.Now.AddYears(-2) });

编写代码将错误数据、可插入数据、可更新数据等进行分类　　

var x = Db.Storageable(list2)
                                      .SplitError(it => string.IsNullOrEmpty(it.Item.Name), "名称不能为空")
                                      .SplitError(it => it.Item.Create<DateTime.Now.AddYears(-1),"不是今年的数据")
                                      .SplitUpdate(it => it.Any(y=>y.Id==it.Item.Id))//存在更新
                                      .SplitInsert(it => true)//剩余的插入
                                      .ToStorage();
Console.WriteLine(" 插入 {0}  更新{1}  错误数据{2} 不计算数据{3}  删除数据{4},总共{5}" ,
                   x.InsertList.Count,
                   x.UpdateList.Count,
                   x.ErrorList.Count,
                   x.IgnoreList.Count,
                   x.DeleteList.Count,
                   x.TotalList.Count
                );

执行代码输出结果：

我们可以看到其中有1条可以插入的，1条可以更新的，并且2条数据数据

输出错误明细：

foreach (var item in x.ErrorList)
{
        Console.WriteLine("id等于"+item.Item.Id+" : "+item.StorageMessage);
}

我们可以看到输出id3和id4是错误的，并且可以输出具体的错误明细

执行更新和插入

x.AsInsertable.ExecuteCommand();
x.AsUpdateable.ExecuteCommand();

三、使用表过滤器

SqlSugar以前也支持了全局过滤器，不过不好用，大部分用户习惯了以表的方式实现过滤器，用法如下

1、创建表过滤器

 SqlSugarClient db = new SqlSugarClient(new ConnectionConfig() { DbType = DbType.SqlServer, ConnectionString = Config.ConnectionString, IsAutoCloseConnection = true });
 db.QueryFilter.Add(new TableFilterItem<Order>(it => it.Name.Contains("a")));  //只有表Order才会生效

2、生效的查询语句

使用了表过滤器后只要带有order表的查询语句，都会自动添加一个条件

 db.Queryable<Order>().ToList();
            //SELECT [Id],[Name],[Price],[CreateTime],[CustomId] FROM [Order]  WHERE  ([Name] like '%'+@MethodConst0+'%') 
 
 db.Queryable<OrderItem, Order>((i, o) => i.OrderId == o.Id)
                .Where(i => i.OrderId != 0)
                .Select("i.*").ToList();
            //SELECT i.* FROM [OrderDetail] i  ,[Order]  o  WHERE ( [i].[OrderId] = [o].[Id] )  AND ( [i].[OrderId] <> @OrderId0 )  AND  ([o].[Name] like '%'+@MethodConst1+'%')

3、禁止全局过滤器

db.Queryable<Order>().Filter(null, false).ToList();
 //SELECT [Id],[Name],[Price],[CreateTime],[CustomId] FROM [Order]

四、一对多查询支持条件过滤　

sqlsugar对于导航查询也是支持的越来越好，下面是一对多查询后在过滤的例子

var list7= Db.Queryable<Order>()
.Mapper(it => it.Items, it => it.Items.First().OrderId)
.Where(it => it.Items.Any(y => y.ItemId == 1)) //以前只支持.any()
.ToList();

五、总结

SqlSugar所有功能都真实来自于客户，并且是多个客户共同的需求，其实我并没有做到什么创新，只是在客户的基础上把他们想要的功能进行了一些设计，如果他们用了不满意，我在这个基础上在

慢慢的修改

源码下载：

https://github.com/donet5/SqlSugar sqlsugar已经持续更新6年之久，也越来越完善，如果说EF或者完它ORM不更新了，那么多一个开源就是多一个选择