首页 > 解决方案 > 清理旧 Entity Framework Core 迁移的推荐方法

问题描述

在开发我们的应用程序一段时间后,我们已经积累了相当多的 EFCore 数据库迁移。由于 EFCore 为每次迁移添加了整个 db 模型的快照,因此这段代码加起来相当多。经过分析,我们大约 80% 的编译时间都花在了迁移上(编译 + Roslyn 分析器)。

所以是时候清理一些旧的迁移了!但是最好的方法是什么?好像没有官方的介绍。。。

我们不需要任何回滚(我们只前滚),所以这让事情变得更简单。我们确实需要支持从头开始创建数据库,并从最近几次迁移中更新数据库。

我试过的:

  1. 核选项似乎是删除所有迁移和模型快照,并创建一个新的初始迁移。虽然这很好,但似乎有点危险。使用这种方法,我们需要非常小心,数据库模式的每个部分都是代码模型的一部分。例如,我们遇到的一个极端情况是 EFCore 还不支持检查约束。所以我们在迁移中添加了一个检查约束,但在代码模型中没有。因此,在创建新的初始迁移时,检查的约束不是其中的一部分。

  2. 作为一个实验,我尝试从所有旧迁移中删除模型快照,因为快照是导致编译时间长的代码的 90%。我发现,EFCore 仅使用快照作为比较工具来进行新的迁移。删除快照后,旧迁移在新数据库上运行时不再执行。

那么有没有更好的方法来完成我想要的?

标签: entity-framework.net-coreentity-framework-core

解决方案


好的,自从提出这个问题以来,我已经对此进行了很多实验。

目前看来,实现这一点的最佳方法是选项 1。选项 2 会好得多,但在实现此 EFCore 功能之前,它对于我的用例来说并不可行(支持现有的带有迁移的数据库,并支持空数据库)。

选项 1 也有一些我偶然发现的陷阱(也许更多我没有偶然发现)。所以这就是我的做法:

创建一个新的初始迁移:

  1. 确保您现有的所有迁移都已应用于您的数据库。我们将创建一个新的初始迁移,因此尚未应用的迁移将丢失。
  2. 删除旧的 EFCore 迁移文件和数据库快照文件。
  3. 从数据库的当前状态创建一个新的初始迁移。(例如通过dotnet ef migrations add Initial-PostCleanup。)

这种新迁移仅与新数据库兼容,因为它将创建所有表(如果任何表、约束等已经存在,则会失败)。所以现在我们要让这个迁移与现有的数据库兼容:

  1. 通过 为新的初始迁移创建一个 SQL 脚本dotnet ef migrations script -o script.sql
  2. 删除创建表的第一个事务(直到第一个GO__EFMigrationsHistory
IF OBJECT_ID(N'[__EFMigrationsHistory]') IS NULL
BEGIN
    CREATE TABLE [__EFMigrationsHistory] (
        [MigrationId] nvarchar(150) NOT NULL,
        [ProductVersion] nvarchar(32) NOT NULL,
        CONSTRAINT [PK___EFMigrationsHistory] PRIMARY KEY ([MigrationId])
    );
END;

GO
  1. 删除在表中插入新条目的最后一个事务__EFMigrationsHistory
INSERT INTO [__EFMigrationsHistory] ([MigrationId], [ProductVersion])
VALUES (N'20190704144924_Initial-PostCleanup', N'2.2.4-servicing-10062');

GO
  1. 删除GO命令,因为我们会将创建脚本放在 IF 语句中:
    替换GO\r\n\r\n为空。
  2. 现在打开您的迁移文件(C# 文件,而不是 sql 文件)并将Up方法替换为以下内容:
protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.Sql(@"
DECLARE @migrationsCount INT = (SELECT COUNT(*) FROM [dbo].[__EFMigrationsHistory])
IF @migrationsCount = 0
BEGIN
    % PASTE YOUR EDITED SQL SCRIPT HERE %
END
");
}

完毕!现在一切都应该正常了!

请务必比较新数据库的数据库架构和前后数据。如果您的 EF 代码模型不属于新数据库的一部分,则所有不属于的内容。


推荐阅读