C#的Migrations在EF Core中是什么?如何管理数据库架构的变更?

星降
发布: 2025-11-21 03:11:20
原创
749人浏览过
<p>Migrations 是 EF Core 中管理数据库架构变更的机制,通过将 C# 模型类的更改转换为可追踪的 SQL 脚本,实现数据库与代码结构的同步。当模型发生变化时(如新增属性或表),需添加迁移记录(dotnet ef migrations add),生成包含 Up()/Down() 方法的迁移文件,再通过 dotnet ef database update 应用到数据库。支持回滚操作(--to 指定版本)和生成 SQL 脚本(script 命令)供生产环境审核,确保变更安全可控,配合版本工具提升团队协作效率。</p>

c#的migrations在ef core中是什么?如何管理数据库架构的变更?

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. 修改模型后添加新迁移

千图设计室AI海报
千图设计室AI海报

千图网旗下的智能海报在线设计平台

千图设计室AI海报 172
查看详情 千图设计室AI海报
例如给 Blog 类增加一个 Description 字符串属性:
dotnet ef migrations add AddBlogDescription
登录后复制
EF 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 等工具,团队协作更安全高效。

以上就是C#的Migrations在EF Core中是什么?如何管理数据库架构的变更?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号