EF相关的内容园子里已经有很多很好的文章了,这篇只是把自己之前的一些整理搬运到这里,抛砖引玉,温故知新。
Migrations确实是个好东西,至少就升级维护Database方面,帮助笔者脱离苦海。另一个项目中开发阶段忽视了DB升级的处理方面的问题,导致每次项目上线都很难去处理DB。因为只有最新版本的Script,如果表结构没有变化还好一点,如果表结构有变动几乎没办法处理。甚至很难比对出上一次release版本的db和最新的db之间的区别。利用Migrations,我们可以记录每次db的变动,甚至可以将初始化的数据处理成一个单独的Migrations用于Restore DB. 对于某些基于特定版本的问题,也可以轻松的将DB还原到出现问题的环境。正文:既可以利用Entity去生成Migrations,也可以通过工具利用现有的db去生成Migrations.准备工作(具体怎么安装,容我再研究一下):(目前最新版本应该是2.2,参见园子里的)
Entity Framework Core .NET Command Line Tools 2.0.0-rtm-26452- Microsoft.EntityFrameworkCore.SqlServer 2.0.3
- Microsoft.EntityFrameworkCore.Tools 2.0.3
- Microsoft.EntityFrameworkCore.Design 2.0.3
DotNetCliToolReference:
Microsoft.EntityFrameworkCore.Tools.DotNet 2.0.0
以Code First由Entity生成Migrations为例(笔者使用的是Abp,具体使用时集成的类与接口可能会有出入)
1 public class Area : FullAuditedEntity, IMustHaveTenant2 {3 public virtual string Name { get; set; }4 public virtual string Remark { get; set; }5 public virtual string IndexTitle { get; set; }6 public int TenantId { get; set; }7 }
此处由于集成自FullAuditedEntity类,会自动的为Area的Entity添加自增的Id,以及类似与CreationTime等统计相关的字段.
Entity建好之后,需要在xxxDbContext中声明一下你的Entity.public virtual DbSetArea { get; set; }
此处有两个作用生成Migrations时确保识别出这个Entity
允许使用Repository与dotnet命令类似,dotnet ef的相关命令都可以使用 --help来查看具体用法.
我们使用dotnet ef migrations add AddArea命令来为刚刚创建的Entity生成Migrations.这个命令会添加两个新的文件,分别是对应的Migrations文件和Designer文件.另外这个命令会修改x'x'xDbContextModelSnapshot.cs 文件.暂时我们只需要关注Migrations文件例如1 public partial class addIndexTitle : Migration 2 { 3 protected override void Up(MigrationBuilder migrationBuilder) 4 { 5 migrationBuilder.AddColumn( 6 name: "IndexTitle", 7 table: "Component", 8 nullable: true); 9 10 migrationBuilder.AddColumn(11 name: "IndexTitle",12 table: "Area",13 nullable: true);14 }15 16 protected override void Down(MigrationBuilder migrationBuilder)17 {18 migrationBuilder.DropColumn(19 name: "IndexTitle",20 table: "Component");21 22 migrationBuilder.DropColumn(23 name: "IndexTitle",24 table: "Area");25 }26 }
(此处只是举例说明,并非实际由Area实体生成的Migration)
可以看到两个方法Up和Down,这两个方法就是你在升级或降级db时会去执行的方法。当然你也可以不写实体,直接生成一个空的Migration文件来初始化数据等.如public partial class InitialDB: Migration{ protected override void Up(MigrationBuilder migrationBuilder) { var sql = “Insert into ....” migrationBuilder.sql(sql); } protected override void Down(MigrationBuilder migrationBuilder) { }}
如果你不需要或者是想删除这个Migration 使用命令
dotnet ef migrations remove这个命令会依次倒叙移除你的Migration,前提是这个Migrations没有更新到DB中.成功生成Migration后需要把Migration的改动升级到DB中,此时需要执行命令dotnet ef database update这个命令如果不添加任何参数,无论你的DB当前处于哪个Migration,都会更新到最新的Migration.如果你在update后添加 某一个Migration的名字作为参数,DB将更新至指定的Migration(可以降级DB)当然以上所有工作的前提都是你要连接到某一个真实存在的DB,连接的方式不再赘述了.此外,如果是某些特定环境,你不能或很难去执行上面的命令来更新DB.这时你可以将Migrator文件Publish出来,作为一个单独的项目去执行,当然你要修改对应的config文件来确保你的配置正确。之后更新DB时你只需要在这个Migrator包的路径下cmd中执行dotnet XXXX.Migrator.dll (具体名字未定,并非一定是Migrator)来更新DB.