探索.NET中的EF Core迁移：数据库版本控制与更新

大家好，欢迎来到今天的讲座。今天我们要聊聊.NET中的EF Core迁移，这可是数据库版本控制和更新的神器。如果你还在为手动管理数据库变更而烦恼，那么EF Core迁移绝对是你的好帮手。接下来，我会用轻松诙谐的语言，带你一步步了解这个强大的工具。

什么是EF Core迁移？

简单来说，EF Core迁移（Migrations）是Entity Framework Core中用于管理和应用数据库模式变更的功能。它可以帮助你：

版本控制：记录每次数据库结构的变化。
自动化更新：自动生成并执行SQL脚本，确保数据库与代码同步。
回滚操作：在需要时轻松回滚到之前的版本。

想象一下，你正在开发一个项目，突然发现需要添加一个新的字段到表中。以前你可能需要手动编写SQL脚本，然后在各个环境中执行。而现在，有了EF Core迁移，你可以通过几行命令轻松搞定这一切。

创建第一个迁移

假设我们有一个简单的Blog实体类：

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
}

我们已经创建了EF Core的DbContext类：

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder options)
        => options.UseSqlServer("YourConnectionStringHere");
}

现在，我们需要添加一个新的字段Rating到Blog类中：

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    public int Rating { get; set; } // 新增字段
}

1. 添加迁移

要将这个变更应用到数据库中，首先需要创建一个迁移。打开命令行工具（如PowerShell或终端），导航到项目目录，然后运行以下命令：

dotnet ef migrations add AddRatingToBlog

这条命令会生成一个新的迁移文件，通常位于Migrations文件夹下。文件名类似于20231010123456_AddRatingToBlog.cs。打开这个文件，你会看到类似这样的内容：

public partial class AddRatingToBlog : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.AddColumn<int>(
            name: "Rating",
            table: "Blogs",
            nullable: false,
            defaultValue: 0);
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropColumn(
            name: "Rating",
            table: "Blogs");
    }
}

Up方法定义了如何将变更应用到数据库，而Down方法则定义了如何撤销这些变更。非常直观，对吧？

2. 应用迁移

接下来，我们需要将这个迁移应用到数据库中。继续在命令行中运行以下命令：

dotnet ef database update

这条命令会根据迁移文件生成并执行相应的SQL脚本，自动更新数据库结构。你现在可以去查看数据库，你会发现Blogs表中已经多了一个Rating字段。

管理多个迁移

随着时间的推移，你的项目可能会经历多次变更，因此会有多个迁移文件。EF Core迁移系统会帮助你管理这些变更，确保它们按顺序应用。

查看迁移历史

你可以使用以下命令查看当前已应用的迁移：

dotnet ef migrations history

这将列出所有已应用的迁移及其时间戳。例如：

20231010123456_AddRatingToBlog
20231011094532_AddAuthorToBlog

回滚迁移

如果你不小心应用了一个错误的迁移，或者需要回滚到之前的版本，可以使用以下命令：

dotnet ef database update [TargetMigration]

例如，如果你想回滚到AddRatingToBlog之前的状态，可以运行：

dotnet ef database update 20231010123456_AddRatingToBlog

这将撤销所有在此之后的迁移。

数据库初始化

有时候，你可能需要从头开始初始化数据库。EF Core提供了几种方式来实现这一点。

1. 删除所有迁移

如果你想从头开始，可以删除所有的迁移文件，并重置数据库。首先，删除Migrations文件夹中的所有文件，然后运行以下命令：

dotnet ef database drop

这将删除现有的数据库。接下来，你可以重新创建初始迁移并应用它：

dotnet ef migrations add InitialCreate
dotnet ef database update

2. 使用`EnsureCreated`

如果你只是想快速创建数据库而不使用迁移，可以使用EnsureCreated方法。在Program.cs或Startup.cs中调用：

using (var context = new BloggingContext())
{
    context.Database.EnsureCreated();
}

不过需要注意的是，EnsureCreated不会跟踪任何迁移历史，因此它不适合长期使用。对于生产环境，建议始终使用迁移来管理数据库变更。

多环境支持

在实际项目中，你可能会有多个环境（如开发、测试、生产）。EF Core迁移可以通过配置不同的连接字符串来支持多环境部署。

在appsettings.json中，你可以为每个环境定义不同的连接字符串：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;",
    "ProductionConnection": "Server=prod-server;Database=Blogging;User Id=sa;Password=yourpassword;"
  }
}

然后在Program.cs中，根据环境选择合适的连接字符串：

var builder = WebApplication.CreateBuilder(args);

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<BloggingContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
}
else
{
    builder.Services.AddDbContext<BloggingContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionConnection")));
}

这样，你就可以在不同的环境中轻松切换数据库连接，而不需要修改代码。

迁移中的数据种子

有时，你可能希望在迁移时向数据库中插入一些初始数据。EF Core迁移支持在Up方法中执行SQL语句或调用C#代码来实现这一点。

例如，假设你想在创建Blogs表时插入一些示例数据，可以在迁移文件中添加以下代码：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.CreateTable(
        name: "Blogs",
        columns: table => new
        {
            BlogId = table.Column<int>(nullable: false)
                .Annotation("SqlServer:Identity", "1, 1"),
            Url = table.Column<string>(nullable: true),
            Rating = table.Column<int>(nullable: false)
        },
        constraints: table =>
        {
            table.PrimaryKey("PK_Blogs", x => x.BlogId);
        });

    migrationBuilder.Sql("INSERT INTO Blogs (Url, Rating) VALUES ('https://example.com', 5)");
}

这段代码会在创建Blogs表的同时插入一条示例记录。当然，你也可以使用更复杂的方式，比如调用C#方法来插入数据。

结语

好了，今天的讲座就到这里。通过EF Core迁移，你可以轻松管理数据库的版本控制和更新，避免手动编写和执行SQL脚本的麻烦。无论你是刚开始学习.NET，还是已经是一名经验丰富的开发者，EF Core迁移都将成为你开发过程中不可或缺的工具。

如果你还有其他问题，或者想了解更多关于EF Core的高级功能，欢迎随时提问！谢谢大家，祝你们编码愉快！