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

转自:https://chowdera.com/2021/01/20210131204455663j.html
一、数据导入有哪些难题
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(it => it.Name.Contains("a"))); //只有表Order才会生效
2、生效的查询语句
使用了表过滤器后只要带有order表的查询语句，都会自动添加一个条件

db.Queryable().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().Filter(null, false).ToList();

//SELECT [Id],[Name],[Price],[CreateTime],[CustomId] FROM [Order]
　　

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

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

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

慢慢的修改