EF Core 迁移代码

列重命名

需要自定义迁移的一个重要示例就是重命名属性时。 例如，如果你将属性从 Name 重命名为 FullName，EF Core 将生成以下迁移：

migrationBuilder.DropColumn(
    name: "Name",
    table: "Customers");

migrationBuilder.AddColumn<string>(
    name: "FullName",
    table: "Customers",
    nullable: true);

　　EF Core 通常无法知道何时要删除列并创建新列（两个不同的更改），何时应对列重命名。 如果按原样应用上述迁移，你的所有客户名称都将丢失。 若要重命名列，请将上面生成的迁移替换为以下内容：

migrationBuilder.RenameColumn(
    name: "Name",
    table: "Customers",
    newName: "FullName");

提示

当某个操作可能会导致数据丢失（例如删除某列），搭建迁移基架过程将对此发出警告。 如果看到此警告，务必检查迁移代码的准确性。

添加原始 SQL

虽然可以通过内置 API 重命名列，但在许多情况下这是不可能的。 例如，我们可能想用一个新的 FullName 属性替换现有的 FirstName 和 LastName 属性。 EF Core 生成的迁移如下所示：

migrationBuilder.DropColumn(
    name: "FirstName",
    table: "Customer");

migrationBuilder.DropColumn(
    name: "LastName",
    table: "Customer");

migrationBuilder.AddColumn<string>(
    name: "FullName",
    table: "Customer",
    nullable: true);

　　如前所述，这会导致不必要的数据丢失。 为了从旧列传输数据，我们重新排列迁移并引入原始 SQL 操作，如下所示：

migrationBuilder.AddColumn<string>(
    name: "FullName",
    table: "Customer",
    nullable: true);

migrationBuilder.Sql(
@"
    UPDATE Customer
    SET FullName = FirstName + ' ' + LastName;
");

migrationBuilder.DropColumn(
    name: "FirstName",
    table: "Customer");

migrationBuilder.DropColumn(
    name: "LastName",
    table: "Customer");

通过原始 SQL 进行任意更改

原始 SQL 还可用于管理 EF Core 不知道的数据库对象。 为此，请在不进行任何模型更改的情况下添加迁移；系统将生成一个空迁移，然后你可以使用原始 SQL 操作填充该迁移。

例如，以下迁移将创建一个 SQL Server 存储过程：

migrationBuilder.Sql(
@"
    EXEC ('CREATE PROCEDURE getFullName
        @LastName nvarchar(50),
        @FirstName nvarchar(50)
    AS
        RETURN @LastName + @FirstName;')");

 提示

当某个语句必须是 SQL 批处理中的第一个或唯一一个语句时，请使用 EXEC。 它还可以用来解决幂等迁移脚本中的分析程序错误，当表中当前不存在引用的列时，可能会发生此类错误。

这可用于管理数据库的方方面面，包括：

• 存储过程
• 全文搜索
• 函数
• 触发器
• 视图

删除迁移

Remove-Migration　

列出迁移

Get-Migration

重置所有迁移

在某些极端情况下，可能需要删除所有迁移并重新开始。 这可以通过删除 Migrations 文件夹并删除数据库来轻松完成；此时，你可以创建一个新的初始迁移，其中将包含当前的整个架构。

你还可以重置所有迁移并创建单个迁移，而不会丢失数据。 此操作有时称为“更正”，涉及一些手动操作：

• 删除 Migrations 文件夹
• 创建新迁移并为其生成 SQL 脚本
• 在数据库中，删除迁移历史记录表中的所有行
• 在迁移历史记录中插入一行，以记录第一个迁移已经应用，因为表已经存在。 insert SQL 是上面生成的 SQL 脚本中的最后一个操作。

警告

删除 Migrations 文件夹后，所有自定义迁移代码都将丢失。 若要保留任何自定义项，必须手动将其应用到新的初始迁移。