C#中如何执行数据库的架构迁移?使用什么工具?

来源:这里教程网 时间:2026-02-21 17:28:07 作者:

在C#项目中执行数据库架构迁移,最常用的方式是使用 Entity Framework Core (EF Core) 提供的迁移功能。它能帮助你通过代码管理数据库结构的变化,比如创建表、修改字段、添加索引等,而无需手动编写SQL脚本。

使用 EF Core 进行数据库迁移

EF Core 内置了强大的迁移工具,配合 .NET CLI 或 Visual Studio 可以轻松实现数据库架构变更。

主要步骤如下:

定义实体类:用C#类表示数据库中的表(例如 User、Product)。 配置 DbContext:继承
DbContext
,并在其中声明
DbSet<t></t>
属性。
安装 EF Core 工具包:确保项目中引用了
Microsoft.EntityFrameworkCore.Tools
(开发时使用)和对应数据库提供程序(如 SQL Server、SQLite、Npgsql 等)。
创建初始迁移使用 .NET CLI:
dotnet ef migrations add InitialCreate
或使用 Visual Studio Package Manager Console:
Add-Migration InitialCreate
这会生成一个包含
Up()
Down()
方法的迁移文件。
应用迁移到数据库.NET CLI:
dotnet ef database update
Visual Studio:
Update-Database
此操作将执行迁移,同步数据库结构。

自动化部署中的迁移执行

在生产环境中,通常不手动运行命令,而是通过代码或发布流程自动应用迁移。

在程序启动时自动迁移(适用于简单场景):
<font>using var scope = app.Services.CreateScope();
var context = scope.ServiceProvider.GetRequiredService<AppDbContext>();
context.Database.Migrate(); // 自动应用待定迁移</font>
推荐做法:在 CI/CD 中使用 ef.exe 或 dotnet ef
构建完成后,在发布阶段执行:
dotnet ef database update --connection "Server=..."

其他可用工具

除了 EF Core,还有其他一些工具可用于C#项目的数据库迁移:

FluentMigrator:一个基于 .NET 的迁移框架,支持多种数据库,适合不使用 EF 的项目。通过 C# 代码定义迁移,可集成到 CI 流程。 DBUp:将 SQL 脚本存储在项目中,按顺序执行,强调“每次只运行一次”的原则,适合需要精细控制 SQL 的团队。 Raw SQL 脚本 + 版本管理:配合工具如 RoundhousE,使用命名规范的 SQL 文件进行版本控制。

最佳实践建议

每次模型更改后及时创建迁移,并审查生成的代码。 避免在迁移中包含大量数据操作(
SeedData
建议单独处理)。
不要随意修改已提交的迁移文件,尤其是在团队协作中;如有错误,新增修复迁移。 将迁移文件纳入版本控制系统(如 Git)。

基本上就这些。对于大多数现代C#项目,EF Core 的迁移机制已经足够强大且易于维护。

相关推荐