Entity Framework 的迁移功能(Migrations)是一种将代码中的模型变更同步到数据库的机制。它能帮助开发者在不丢失数据的前提下,安全地更新数据库结构,比如添加表、修改字段、调整约束等。
迁移的基本原理
当你使用 Code First 模式开发时,实体类的变化不会自动反映到数据库中。迁移通过生成差异脚本,把模型变更转化为可执行的 SQL 语句,并记录版本顺序,确保团队协作和生产环境的一致性。
每次迁移都会生成一个包含 Up() 和 Down() 方法的 C# 类文件:
- Up() 定义如何应用更改
- Down() 定义如何回滚更改
启用并使用迁移
以下是使用迁移的常见步骤:
1. 启用迁移(首次使用)
在 Visual Studio 的包管理器控制台运行:
Enable-Migrations
这会在项目中创建一个 Migrations 文件夹,并生成初始配置类 Configuration.cs,你可以在这里设置自动迁移、种子数据等。
2. 添加一次迁移
当你修改了实体类后,例如新增一个属性:
public class User {
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; } // 新增字段
}
执行命令:
Add-Migration AddEmailToUser
EF 会对比当前模型与上次迁移的状态,生成一个新的迁移类,如:
public partial class AddEmailToUser : DbMigration
{
public override void Up()
{
AddColumn("dbo.User", "Email", c => c.String());
}
<pre class="brush:php;toolbar:false;">public override void Down()
{
DropColumn("dbo.User", "Email");
}}
3. 更新数据库
生成迁移文件后,将其应用到数据库:
Update-Database
这个命令会执行所有未应用的迁移,包括创建列、索引或外键等操作。你也可以指定迁移版本来回退:
Update-Database -TargetMigration: "InitialCreate"
处理常见场景
迁移不仅能处理简单字段增减,还能应对更复杂情况:
重命名字段:使用 RenameColumn 方法避免数据丢失 设置默认值:在 AddColumn 时指定 defaultValue 添加索引:使用 CreateIndex 数据迁移:在 Up() 中调用 Sql("UPDATE ...") 执行自定义 SQL例如为 Email 字段添加唯一索引:
CreateIndex("dbo.User", "Email", unique: true);
生产环境注意事项
在发布到生产环境前,建议:
审查生成的迁移脚本是否合理 备份数据库再执行更新 使用 Update-Database -Script 生成 SQL 脚本,手动审核后执行 避免启用自动迁移(Auto Migrations),因为它难以控制和审查基本上就这些。只要记住“改模型 → Add-Migration → Update-Database”这个流程,就能高效管理数据库演化。迁移让数据库版本和代码保持同步,是现代 .NET 开发中不可或缺的一环。
