ASP.NET Core 8.0学习笔记（二十七）——数据迁移：Migrations深入与其他迁移命令

news/2025/2/24 9:07:19

一、数据库架构的管理

1.EF Core提供两种方式来保持EF Core的模型与数据库保持同步。
(1)以数据库为准：反向工程（Db First），适用于中大型工程
(2)以代码为准：数据迁移（Code First），适用于小型工程
2.关于Nuget包：Microsoft.EntityFrameworkCore.Design：常用于反向工程 Tools：数据迁移
3.迁移方式：
(1)当引入的数据模型更改时，添加迁移操作时，EF Core将当前模型与旧模型的快照进行比较，确定差异并生成迁移源文件
注意：主要是比较模型类与模型配置类（IEntityTypeConfiguration接口实现类以及DbContext类）修改前后的差异（修改前的代码保存在快照当中），然后生成对应的迁移脚本
(2)生成新的迁移后，迁移的记录将保存在Migration文件夹中。EF也将在数据库中记录所有的迁移变化

二、深入研究Migrations中的两个方法

1.获取Migrations脚本：新建实体类与配置类，以及DbContext,然后执行数据库迁移指令，观察生成的数据库脚本：
实体模型：
在这里插入图片描述

配置类：
在这里插入图片描述

数据库上下文类：
在这里插入图片描述

执行数据库迁移指令：
在这里插入图片描述

生成的Migration脚本如下：
在这里插入图片描述

2.引入概念：
(1)向上迁移、向下迁移：使用迁移脚本，可以对当前连接的数据库执行编号更高的迁移，这个操作叫做向上迁移（Up），也可以执行将数据库回退到旧的迁移，这个操作称为“向下迁移”。
(2)注：除非有特殊需要，否则不要删除Migrations文件夹下的代码（回退数据库版本使用）
3.代码分析：
(1)根目录下的文件
在这里插入图片描述

(2)Intial.cs的Up与Down方法：
Up：生成这张表或执行更新操作所需要的代码脚本
Down:回退当前操作所需要执行的代码
在这里插入图片描述

若在实体中添加一个属性Height，同样执行数据库迁移命令，生成的脚本如下：
在这里插入图片描述

注意，在生成的数据库中会有一张表，用于记录Migration记录，若随意删除则会报错。
4.但是Migration文件夹中的文件也不是一定不能删除。一般情况下只需要将生成的数据库整个删除以后，再删掉Migrations文件夹即可。此时重新运行Add-Migration命令以及update-database就不会出现任何问题。（因为快照等都被删除了，等于重新开始建库）
三、其他的Migration迁移指令
1.Update-Database XXX:将数据库回滚到XXX的状态，迁移脚本不动
在这里插入图片描述

将数据库回滚到Initial状态
2.删除最后一次的迁移脚本：Remove-Migration
在这里插入图片描述

3.Script-Migration:生成迁移Sql代码。Update-Database可以更新数据库，执行该命令可以生成SQL的更新脚本，手动更新数据库，有利于DBA对数据库进行管理以及恢复。
在这里插入图片描述

五、重置迁移

1.若需要重置所有迁移，但是又需要保留测试数据，可以按照以下方法操作：
(1)删除Migrations文件夹
(2)删除对应数据库中__EFMigrationsHistory表中的数据（不是删除表，只是清除数据）
(3)创建新的迁移并为其生成SQL脚本
(4)在数据库的迁移记录表（__EFMigrationsHistory）中插入一行，以记录刚才的迁移已经应用
2.示例：
(1)删除Migrations文件夹，重新执行Migration：
在这里插入图片描述