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

时间:2022-02-19 08:09:10

前言

最近打算用.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:

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

然后建立EFCoreContext类

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

自动创建数据库

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

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

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

数据迁移

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

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

输入命令:Add-Migration init(执行此命令项目生成一个目录(Migration))

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

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

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

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

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

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

然后我们执行命令:

Update-Database

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


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

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

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

我们看看xxxxxx_init.cs文件:

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

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

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

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

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

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

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

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

然后我们开始迁移..

 Add-Migration  x2 (这里是迁移版本名称,可自定义,可以根据版本回滚)

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

Update-Database x2

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

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

删除迁移

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

执行命令如下:

 Remove-Migration

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

迁移回滚

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

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

执行如下: 

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

我们执行  Update-Database init   

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

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

生成迁移SQL

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

 Script-Migration

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

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