使用FluentMigrator进行数据库迁移
2019-12-01

介绍

在开发的过程中,经常会遇到数据库结构变动(表新增、删除,表列新增、修改、删除等)。开发环境、测试环境、正式环境都要记性同步;如果你使用EF有自动迁移的功能,还是挺方便的。如果非EF我们需要手工处理,有时候会忘记,繁琐。恰好 网上有提供的工具来实现类似EF的迁移功能。如:SQL Server Data ToolsFluent MigratorRoundhousEDbUpConclusion;本文将着重分享下如何使用Fluent Migrator进行数据库迁移。

Fluent Migrator

Fluent Migrator.NET下的一个数据库迁移框架。我们可以利用Migration基类,编写数据结构改变,它有两个方法Up()Down()up方法用于升级迁移,down用于回滚。

 如何使用Fluent Migrator

下面以创建一个论坛,帖子表为例。

创建一个迁移类库,命名为DatabaseMigration,在命令行中安装:Install-Package FluentMigrator

 

然后添加一个迁移类CreateTopicTable_201811091800.cs继承Migration,代码如下

[Migration(201811091800)] public class CreateTopicTable_201811091800 : Migration { public override void Up() { Create.Table("Topic") .WithColumn("Id").AsInt64().PrimaryKey().Identity() .WithColumn("TopicTitle").AsString(50); } public override void Down() { Delete.Table("Topic"); } }

我们创建了一个继承Migration类。实现了接口Up()和down()方法,在up方法了创建一个Topic表并且添加了两个字段,我们进行升级迁移时将会调用up方法;down方法里 我们可以进行回滚删除该表。[Migration(201811091800)] 这个是版本定义,数据库会自动创建一个表进行版本维护。FluentMigrator还提供其他的接口如:Alter,Create,Rename,Insert,Delete,Execute等。 

运行迁移

执行迁移利用Migrate.exe工具,(Install-Package FluentMigrator.Console)安装之后会出现在packagesFluentMigrator.Console.3.1.3中

打开cmd运行以下命令:

packagesFluentMigrator.Console.3.1.3et461anyMigrate.exe /conn "Data Source=.;Initial Catalog=migrationDemo;Persist Security Info=True;User ID=sa;Password=123;"/db sqlserver2014 /assembly  "DatabaseMigrationinDebugDatabaseMigration.dll"

执行成功

打开数据库我们会发现多了一张Version表

打开version表;你会发现表里面有一条迁移记录,version(版本号是可以自定义的),appliedon(执行时间),description(描述如果不自定义默认是类名称)

回滚数据库

业务的变更,经常会变动数据表或表结构,使用面命令很容易进行管理。

Migrate.exe /conn "Data Source=.;Initial Catalog=migrationDemo;Persist Security Info=True;User ID=sa;Password=lee2018;" /db sqlserver2014 /assembly "DatabaseMigrationinDebugDatabaseMigration.dll" /task rollback --steps=1

 你会发现 命令结尾处多了task rollback --steps=1 ;如果没有task  默认是指migrate up。 task用法如图

 输出显示 CreateTopicTable_201811091800 reverted 恢复成功。此时实际上执行的是 Delete.Table("Topic");。

总结

使用 Fluent Migrator 很容易的去升级迁移和回滚数据库。最后分享下迁移助手小工具

截图如下:图1 可以直接执行命令

 

图2,如果在已有的数据表的情况下,利用自动创建免去了手工去编写迁移文件

最后附上源码地址https://github.com/ChengLab/DBMigrationTool 

参考:

Ants-----https://www.cnblogs.com/ants/p/4037312.html

官网----https://fluentmigrator.github.io/index.html

, 1, 0, 9);