谈谈EF Core实现数据库迁移

作为程序员，在日常开发中，记忆犹新的莫过于写代码，升级程序。升级程序包含两部分：一是，对服务程序更新；二是，对数据库结构更新。本篇博文主要介绍数据库结构更新，在对数据库升级时，不知道园友们是否有如下经历：

1）脚本文件中建表语句未作判断是否存在，而导致执行失败。

2）脚本文件中修改字段在建表语句之前，关联存储过程执行顺序颠倒而导致执行失败。

3）各个历史脚本文件代码重复又重复，如存储过程代码在多个脚本文件中存在。

4）新客户往往要执行多个脚本文件，才能使用最新的产品。

可以说，数据库升级是否能成功，成了众多程序员特别是团队管理者的心病了。接下来，详细介绍使用EF Core实现数据库升级。

一.使用EF Core命令方式进行迁移数据库

1. 程序包管理器控制台(PMC)迁移数据库

1）准备好实体(对应数据库表)，数据库操作类，数据库连接字符串，及数据库操作服务。

a.学生实体类

public class Student
{
   public int ID { get; set; }
   public string FirstName { get; set; }
   public string LastName { get; set; }
}

b.数据库操作类

public class SchoolDB:DbContext
{
   public SchoolDB(DbContextOptions<SchoolDB> options) : base(options) 
   { }

   public DbSet<Student> Students { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder) {
            modelBuilder.Entity<Student>().ToTable(nameof(Student));
    }
}

c.在appsettings.json中配置数据库连接字符串

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "SchoolDB": "Server=ERQFJF;Database=SchoolDB;User ID=sa;Password=******"
  }
}

d.在Startup中注入数据库操作服务

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();
    services.AddDbContext<SchoolDB>((options) => { options.UseSqlServer(Configuration.GetConnectionString("SchoolDB")); });
}

e.如下图：是整个代码初始架构及数据库情况，方便后续操作过程进行比较

2）打开PMC，如下图

3）接下来可以在PMC中输入相关命令来创建迭代版本，升级数据库。

a.使用Add-Migration命令创建迭代版本：如下图

b.使用Update-Database升级数据库：如下图

升级数据库命令Update-Database

升级后结果

4）当实体模型有更新时(如新增实体，新增实体属性，修改实体属性等)，重复2(使用Add-Migration创建迭代文件)，3(使用Update-Database更新数据库)步骤，实现数据 库(表)与程序(实体)同步，达成数据库升级。

2.迭代文件说明，如下图

3.缺陷说明：

PMC只能在Visual Studio下运行，在生产环境下无法使用，即无法在生产环境下使用PMC升级数据库。

或许有园友会说，可以把其导出脚本放到数据库中执行，这种方式只适合于首次使用产品的用户，对于已经使用产品的用户，则会存在以下问题：

1）导出的脚本不能直接使用，如创建表，新增字段等没有做任何判断，需要修改相关脚本。

2）若有很多客户，每个客户的升级的版本都不一致，要逐个客户导出适用的脚本，工作量巨大

3）有些客户的数据库服务器管理很严，外部人员不能直连数据库操作

二.自动升级数据库

1.前面2个步骤，与PMC一致

准备好实体(对应数据库表)，数据库操作类，数据库连接字符串，及数据库操作服务。

通过Add-Migration命令创建迭代文件

2.通过DatabaseFacade.Migrate方法进行自动升级数据库，代码如下图

三.总结

1.通篇介绍下来，基本上是关于数据库升级。那什么是数据库迁移：其实就是数据库升级，数据库架构更新。

2.使用命令方式升级数据库，除了PMC，还有CLI，其操作步骤相似，只是命令不一样。下表列出了两种方式的命令：

3.使用DatabaseFacade.Migrate()实现自动升级数据库。