EF Core Model更新迁移

在.net 开发中，如你的项目中使用EF进行数据管理，当需要新增、修改EF Model结构时，怎样才能自动化的更新DB中的真实Table。以及对这些更改进行一个版本控制。

下面我将使用一个ASP.NET Core的web应用程序，来演示该操作：
1、Model

2、DB Table

假设现在我们要在Model/Student.cs 加一个属性

 public string NewColForTest { get; set; }

　　新的模型变为：

对应的Table，我们希望变成如下

操作步骤：

建一个ASP.NET Core web Application，用EF Core连接好数据库，建好Student.cs

编辑*.csproj 文件，添加highlight内容

 

cmd 定位到项目根目录并执行以下语句

dotnet ef migrations add InitialCreate

　　

将初始化EF Core用于迁移的文件。InitialCreate是其中一个迁移记录的版本文件名，暂不关心。

现在你的项目中将多出：

【SchoolContext】ModelSnapshot里面记录了要生成db的内容。

20180513071210_【InitialCreate】记录了此次更新（同上个版本）的部分，由于我们是第一次初始化，所以里面记录了全部表结构内容。

【SchoolContext】ModelSnapshot:

partial class SchoolContextModelSnapshot : ModelSnapshot
    {
        protected override void BuildModel(ModelBuilder modelBuilder)
        { 
            modelBuilder
                .HasAnnotation("ProductVersion", "2.0.2-rtm-10011")
                .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);

           ...

            modelBuilder.Entity("ContosoUniversity.Models.Student", b =>
                {
                    b.Property<int>("ID")
                        .ValueGeneratedOnAdd();

                    b.Property<DateTime>("EnrollmentDate");

                    b.Property<string>("FirstMidName");

                    b.Property<string>("LastName");

                    b.Property<string>("NewColForTest");

                    b.HasKey("ID");

                    b.ToTable("Student");
                });

            ...
        }
    }

　　20180513071210_【InitialCreate】:

public partial class InitialCreate : Migration
    {
        protected override void Up(MigrationBuilder migrationBuilder)
        {
            ...

            migrationBuilder.CreateTable(
                name: "Student",
                columns: table => new
                {
                    ID = table.Column<int>(nullable: false)
                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
                    EnrollmentDate = table.Column<DateTime>(nullable: false),
                    FirstMidName = table.Column<string>(nullable: true),
                    LastName = table.Column<string>(nullable: true)
                },
                constraints: table =>
                {
                    table.PrimaryKey("PK_Student", x => x.ID);
                });

           ... 
        }

        protected override void Down(MigrationBuilder migrationBuilder)
        {
            ...
            migrationBuilder.DropTable(
                name: "Student");
        }
    }

　　回到cmd 定位到项目根目录执行

dotnet ef database update

EF Core将为我们跟db同步

现在我们的db应该跟Model是一致的（多余的细节，这里就不赘述了）

做到这里，我们应该清楚EF Core是通过生成/Migrations Folder的内容来实现同步db。

此时还会新生成一个表用于版本记录

EF Core 使用 __MigrationsHistory 表查看是否需要运行任何迁移。 如果 DB 已是最新，则无需运行迁移。

现在开始更改Student.cs

添加新属性NewColForTest

按照我们的猜测，要同步更新db，应该就是更改/Migrations Folder里的内容。把该属性对应的添加上去，然后执行

dotnet ef database update

　　

即可实现同步更新（迁移）。

现在这里可以手动更改/Migrations Folder里的两个文件，然后执行cmd。

那么可以不手动吗？

可以，先执行命令，生成一个新的差异版本Migration，我们命名为UpdateStudent

dotnet ef migrations add UpdateStudent

执行结果：

点开文件

只有差异内容。

 public partial class UpdateStudent : Migration
    {
        protected override void Up(MigrationBuilder migrationBuilder)
        {
            migrationBuilder.AddColumn<string>(
                name: "NewColForTest",
                table: "Student",
                nullable: true);
        }

        protected override void Down(MigrationBuilder migrationBuilder)
        {
            migrationBuilder.DropColumn(
                name: "NewColForTest",
                table: "Student");
        }
    }

　　最后执行

dotnet ef database update

　　

查看db

原有的数据也仍在。完成。

注意：如果命令报错，可以检查是否把iis express退出。

总结：

我觉得很大一个亮点是每次更新都生成一个追踪版本，某些情况下，省去了单独维护sql 脚本的工作。

与EF Code First比较，运行的更加“透明”，让我们更直接的知道发生了什么