<code>ShardingCore</code> 易用、简单、高性能、普适性,是一款扩展针对efcore生态下的分表分库的扩展解决方案,支持efcore2+的所有版本,支持efcore2+的所有数据库、支持自定义路由、动态路由、高性能分页、读写分离的一款组件,如果你喜欢这组件或者这个组件对你有帮助请点击下发star让更多的.neter可以看到使用
Gitee Star 助力dotnet 生态 Github Star
你是否在使用efcore,你是否在使用abp,你是否对目前的分表十分厌恶,手动指定表让你的代码无辜多出很多胶水代码,那么这次的文章可以很好的帮你解决掉当前的困难点,sharding-core 针对efcore的分库分表读写分离的痛点进行扩展,可以完美集成到efcore生态的系统里面,无论你是abp还是其他使用efcore的框架,你确定真的不看一下吗,如何集成abp当时我发布这个库的时候就有很多人问我是否支持,我的回答是支持的,只是个人没有时间去实现。这次已经实现了我这边将分享下如何集成<code>sharding-core</code>到<code>abp vnext</code>中。
距离上一篇博客已经两周了,在这两周期间本人还是做了很多事情,针对优化<code>sharding-core</code>的使用和体验,就在上周五傍晚的时候有个使用abp的同学联系我,问我什么时候支持abp vnext,其实这个计划我很早之前就在issue里面备注了,只是获取用abp的同学没有怎么关注这个类库也没人提出来,所以就搁置了。因为sharding-core是一款几乎可以说可以集成到任何efcore生态下的所以原则上abp上集成应该是没什么难度的,因为本人使用abp不是很多所以这边自己按官方教程进行了初步的项目搭建,然后又用了一会功夫了解了abp源码(之前有了解过)清楚了dbcontext的创建过程所以很快就继承好了一个todoapp
接下来我将用一篇博客的篇幅来介绍如何将<code>sharing-core</code>集成到<code>abp vnext</code>中。
我这边是通过github进行了例子的todoapp 进行下载,下载后是一个集合例子,我们获取TodoApp项目进行单独处理,打开然后编译。
注意如果你自己会新建那么也是一样的
abp:只要你的dbcontext继承至 <code>public class TDbContext:AbpDbContext<TDbContext></code>那么就可以完美使用.
但是sharding-core的使用我们通过readme来查看发现
sharidng-core:只要你的dbcontext继承至<code>public class TDbContext:AbstractShardingDbContext</code>那么你就可以完美使用.
好家伙直接给想自己集成的同学搞蒙蔽了,c#又不是c艹没有多继承啊那怎么办,但是这边其实是有一个误区的就是abp确实需要继承abpdbcontext但是sharding-core是已接口作为依赖来开发的,所以我们只需要实现<code>ISharingDbContext</code> 这个接口就可以了如果需要事务在实现<code>ISupportShardingTransaction</code>
最终我们是通过实现一个抽象基类来继承abpdbcntext并且实现sharding-core需要的接口 AbstractShardingAbpDbContext 这样我们就可以在不破坏abp的同时又兼顾了sharding-core
注意:这边sharing-core让你们继承AbstractShardingDbContext是因为重复写这些接口的实现会很麻烦所以给你们写了一个抽象方便你们使用

通过源码可以看出abp集成需要赋值lazyserviceprovider 因为abp的dbcontext是交由uow自己处理并且需要支持很多特性所以我们在创建dbcontext的时候需要对此处进行赋值注意点。
注意abp默认提供了<code>IEntity<Guid></code>,<code>IHasCreationTime</code>属性较为常用所以我们需要注意如何支持这两种,因为当你用id取模分表或者创建时间分表的使用场景还是比较常见的所以我们需要支持。
因为在insert时如果sharding-core发现对应的分表字段为null就无法继续执行下去,所以为了兼容abp需要支持两个比较常见的需求
首先我们需要知道sharding-core是如何对一个普通的dbcontext进行支持的
如果你的dbcontext有用到以下任意一个接口那么集成起来可能需要自己去实现对应的接口
IDbSetSource 用来接管dbset
IQueryCompiler 用来接管查询编译
IDbContextTransactionManager 用来接管事务开启
IRelationalTransactionFactory 用来接管事务的提交、回滚 和加入
IModelCacheKeyFactory 用来接管dbcontext的模型缓存
IModelCustomizer 用来接管dbcontext的模型初始化前后自定义
如果你的efcore想接入sharding-core并且如果你没有对dbcontext的上述任何接口进行替换那么可以很容易就接入,如果你的efcore在创建的时候有针对上述的接口进行替换,就需要你自己手动进行两边的实现合并。
这边我们假设你没有对上述的dbcontextoptionbuilder的创建进行接口的替换那么你只需要进行如下操作就可以简单接入sharding-core
首先就是默认创建dbcontext替换为sharding-core的配置
原先:
现在:
综上所述我们接入任何efcore的系统只需要进行4步(第一步都可以去掉只需要3步)就可以完美接入了,可以保证使用
修改将todoitem表作为id取模来进行分表演示
默认TodoApp有一个TodoItem实体对象我们首先创建两个空接口
创建TodoItem的分表路由
通过继承默认分表取模路由<code>AbstractSimpleShardingModKeyStringVirtualTableRoute</code>
实现 AbstractShardingAbpDbContext
其中别的接口都和sharding-core一致,为了支持abp的部分自动属性这边进行了新的接口添加用来标识当前的对象是通过什么方式来进行分表的,然后可以高效的通过接口来进行赋值,比如<code>IShardingKeyIsGuId</code>告诉系统是id为guid的进行分表的
既然你讲TodoItem进行了分表,那么你这边需要告诉系统你是按怎么个规则进行分表的,假设我们默认按id取模那么可以继承sharding-core默认提供的取模路由
简单说明就是分表后缀为2位数00-99,5代表模5也就是00,01,02,03,04
<code>builder.ShardingProperty(o => o.Id);</code>告诉框架通过<code>Id</code>字段分表
注意: <code>IShardingTableDbContext</code>如果dbcontext需要实现分表功能必须实现<code>IShardingTableDbContext</code>
到目前为止我们的准备工作已经完成了,接下来需要进行codefirst的支持和具体项目的配置使用了
选中<code>TodoApp.EntityFrameworkCore</code>项目打开<code>TodoAppDbContextFactory</code>替换dbcontext的创建方法,主要是替换codefirst的建表语句
这边是采用了<code>EFCore.Sharding</code>
主要代码就是告诉efcore.tools如何创建对应的dbcontext
然后打开nuget控制台
选中需要生成迁移的项目
启动项设置为
执行命令
到此为止我们的code first已经完成了,系统会自动根据分表的配置来进行创建对应的sql语句
因为<code>sharding-core</code>是基于接口和dbcontext所以只要你的efcore那么基本上你的生态就可以接入<code>sharding-core</code>,主要就是注意1点
自定义替换DbContextOptions的部分服务
dbcontext的构造函数是DbContextOptions或者是他的泛型类
稍微解释下
用来告诉abp,TodoAppDbContext的创建需要使用useSharding,
之后就是<code>sharding-core</code>默认提供的builder,当然你们可以自行封装一下,别忘了在启动的时候
这个千万不能忘
通过添加efcore的日志我们可以清晰地看到abp能够正确的将对应的数据插入进去,并且完全不需要修改现有代码,基本上的零基础使用,简单的配置,
如果您喜欢本库就点点star点点赞,来都来了点个推荐不过分吧。为.net生态做一份贡献,希望各位个多多提issue,和pr十分感激
AbpVNextShardingTodoApp
Github ShardingCore
Gitee ShardingCore
博客
QQ群:771630778
个人QQ:326308290(欢迎技术支持提供您宝贵的意见)
个人邮箱:[email protected]
EFCore.Sharding的迁移思路