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

轻辰同学_2668

轻辰同学_2668

2025-11-21

823人浏览

原创

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

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

Back up GitHub, GitLab, Bitbucket, and Forgejo repositories with gitbackup
Back up GitHub, GitLab, Bitbucket, and Forgejo repositories with gitbackup

从一个配置中运行可重复的跨仓库备份任务,而不是为每个提供商手动编写克隆和导出步骤。

下载
例如给 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 等工具,团队协作更安全高效。

    相关文章

    PHP速学视频免费教程(入门到精通)
    PHP速学视频免费教程(入门到精通)

    PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

    下载

    相关标签:

    git microsoft c# 数据丢失

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    数据分析工具有哪些
    数据分析工具有哪些

    数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

    2023.10.12

    5063

    8

    SQL中distinct的用法
    SQL中distinct的用法

    SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

    2023.10.27

    1031

    4

    SQL中months_between使用方法
    SQL中months_between使用方法

    在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

    2024.02.23

    1329

    5

    SQL出现5120错误解决方法
    SQL出现5120错误解决方法

    SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

    2024.03.06

    7141

    10

    sql procedure语法错误解决方法
    sql procedure语法错误解决方法

    sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

    2024.03.06

    3783

    4

    oracle数据库运行sql方法
    oracle数据库运行sql方法

    运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

    2024.04.07

    7120

    11

    sql中where的含义
    sql中where的含义

    sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

    2024.04.29

    10001

    6

    sql中删除表的语句是什么
    sql中删除表的语句是什么

    sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

    2024.04.29

    1350

    5

    sql中删除一列的命令是什么
    sql中删除一列的命令是什么

    在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

    2024.04.29

    1192

    5

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    Postman Native Git工作流指南
    Postman Native Git工作流指南

    共0课时 | 0人学习

    vscode手册
    vscode手册

    共0课时 | 0人学习

    Git 教程
    Git 教程

    共21课时 | 8.2万人学习