Migrations(迁移) 是 EF Core 中用于管理数据库架构变更的机制。它能将你在 C# 模型类中的更改(比如新增一个属性、修改字段类型或添加新表)转换为对应的数据库结构变更脚本,从而让你以代码方式安全、可追踪地更新数据库。
迁移的核心作用
当你的实体模型发生变化时,数据库并不会自动同步这些变化。Migrations 提供了一种方式,把模型的变更记录下来,并生成可以执行的 SQL 脚本,让数据库结构与代码保持一致。例如:你给一个
Blog类添加了
CreatedDate属性,通过添加并应用迁移,EF Core 会生成一条“为 Blog 表添加 CreatedDate 列”的操作,并在数据库中执行它。
如何使用 Migrations 管理数据库变更
以下是典型的迁移操作流程:
启用迁移:首次使用时,在项目中初始化迁移系统。通常只需执行一次。 添加迁移:每次模型变更后,创建一个新的迁移记录。 更新数据库:将迁移应用到目标数据库,使其结构同步。 回滚迁移:必要时可以撤销最近的变更。具体操作步骤(通过命令行)
确保已安装 Microsoft.EntityFrameworkCore.Tools
包,并在项目目录下使用 .NET CLI 或 Package Manager Console。
1. 添加初始迁移
当你第一次启用迁移时:dotnet ef migrations add InitialCreate这会在项目中生成一个
Migrations文件夹,并创建初始迁移文件(包含创建所有当前模型对应表的代码)。
2. 应用迁移到数据库
执行以下命令将迁移更新到数据库:dotnet ef database update如果数据库不存在,会自动创建;否则按迁移历史逐步更新结构。
3. 修改模型后添加新迁移
例如给Blog类增加一个
Description字符串属性:
dotnet ef migrations add AddBlogDescriptionEF Core 会对比当前模型与上一次迁移的状态,自动生成新增列的代码。
4. 更新数据库以应用变更
dotnet ef database update这条命令会执行所有未应用的迁移,包括刚刚添加的
AddBlogDescription。
5. 回退迁移(可选)
如果你想撤销最后一次迁移:dotnet ef database update PreviousMigrationName或者直接回退到上一步:
dotnet ef database update --to PreviousMigrationName
迁移文件的内容说明
每个迁移生成两个文件:
Timestamp_AddBlogDescription.cs:C# 类,包含
Up()和
Down()方法。
Timestamp_AddBlogDescription.Designer.cs:设计时信息,一般无需手动修改。
Up()
定义了应用此迁移时要执行的操作(如添加列),Down()
定义了撤销该操作的逆向操作(如删除列)。这使得迁移可以双向进行。
生产环境中的建议
在开发阶段频繁使用迁移没有问题,但在生产环境中需谨慎:
每次迁移生成后应审查生成的 SQL 是否合理,尤其是涉及数据丢失的操作(如删除列)。 可通过script命令生成 SQL 脚本,交由 DBA 审核后再执行:
dotnet ef migrations script避免在生产环境直接运行
update,推荐导出脚本并人工确认。
基本上就这些。Migrations 让数据库架构演变得以版本化控制,配合 Git 等工具,团队协作更安全高效。
