ASP.NET CORE系列【六】Entity Framework Core 之数据库迁移

前言

最近打算用.NET Core写一份简单的后台系统,来练练手

然后又用到了Entity Framework Core 

发现园子里有些文章讲得不是那么细节，对于新手小白来说，可能会有点懵。

特意整理了几个细节.

正文

数据迁移

首先EF CORE跟以前的EF6是有不同点的，

微软官网列出的不同点：https://docs.microsoft.com/zh-cn/ef/efcore-and-ef6/features

安装 EF 核心 NuGet 包

若要使用 EF 核心，请为你想要使用的数据库提供程序安装 NuGet 包。 例如，如果目标 SQL Server，你将安装Microsoft.EntityFrameworkCore.SqlServer。

如果你打算使用迁移，则还应安装Microsoft.EntityFrameworkCore.Tools包。

Install-Package Microsoft.EntityFrameworkCore.SqlServer

Install-Package Microsoft.EntityFrameworkCore.Tools

注意：下面的讲解有一部分在前面的文章有出现过，为了照顾没有读前面文章的同学，代码就简单的贴出来。不多做讲解

首先新建一个 Model 类 SysUser：

 

 然后建立EFCoreContext类

自动创建数据库

此时我们的数据库 和数据都已经有了

数据迁移

此时重点来了，当我们已经有数据库表的时候，我们需要修改字段，如何进行迁移

首先打开VS->工具->NuGet包管理器->程序包管理控制台

输入命令：Add-Migration init（执行此命令项目生成一个目录（Migration））

 

我们会发现Model程序集下多了一个文件夹为Migrations里面有3个文件.如下:

 

 

xxxxxxx_init.cs主迁移文件。包含应用迁移（in Up()）和恢复（in Down()）所需的操作。

xxxxxxx_init.Designer.cs - 迁移元数据文件。包含EF使用的信息。

EFCoreContextModelSnapshot.cs - 当前模型的快照。主要用于确定添加下一次迁移时发生了哪些变化.

然后我们执行命令:

Update-Database

如果你的数据库没创建,是第一次,就会执行成功,

如果你前期创建过数据库.但是是第一次创建迁移..就会失败

 

果然报错了，提示我们的表结构已经存在了，

我们看看xxxxxx_init.cs文件：

可以看到，这里第一次生成的迁移方法是按照新增来迁移的..而不是修改。

我们把Up()   Down（）里面的代码删掉

 这样就相当于 本次的迁移，没有做任何操作。

 

 然后我们来创建真正的迁移版本：

 首先添加一个Email字段,然后把UserName的长度改为60

 

 然后我们开始迁移..

 Add-Migration  x2 （这里是迁移版本名称，可自定义，可以根据版本回滚）

 成功创建迁移文件之后,我们更新数据库.

Update-Database x2

 然后Email字段加上了，UserName长度也修改了，UserName的数据也还在。

 

 

删除迁移

 的时候我们刚刚创建了一个迁移,还没应用到数据库,就发现自己需要变更实体.那我们就可以删除这个没有应用的迁移版本.

 执行命令如下:

 Remove-Migration

 注意,这里是没有应用过的迁移,可以删除.如果应用过了.则会收到错误信息  

 

迁移回滚

有些时候,我们需要回滚到之前的一个迁移版本.,比如我们部署的时候,开发版本和稳定版本肯定不一样..

那么我们就会用到回滚命令.

执行如下: 

Update-Database  这里填写需要回滚的版本名称

我们执行  Update-Database init   

然后我们会发现, x2中的长度已经回到30了，Email字段也没有了....

生成迁移SQL

 有的时候,我们的生产数据库,是需要用脚本来创建库的.所以我们也可以直接通过实体来生成SQL脚本.命令如下:

 Script-Migration

 

举一反三：Script-Migration x2  这个脚本可以自定义需要迁移的版本号.文件名,需要生成迁移脚本的上下文