使用FluentMigrator进行数据库迁移

Posted chengtian

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了使用FluentMigrator进行数据库迁移相关的知识,希望对你有一定的参考价值。

介绍

在开发的过程中,经常会遇到数据库结构变动(表新增、删除,表列新增、修改、删除等)。开发环境、测试环境、正式环境都要记性同步;如果你使用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.3 et461anyMigrate.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

以上是关于使用FluentMigrator进行数据库迁移的主要内容,如果未能解决你的问题,请参考以下文章

开源的 .NET 数据库迁移框架

Wix,创建数据库并运行迁移

如何使用 FluentMigrator 创建一对一的外键

如何在 FluentMigrator 中获取最后插入的 id

实体框架迁移 - 如何创建单元测试以确保迁移模型是最新的?

使用 MNIST 数据集进行迁移学习的代码中的“文件名”是啥?