数据库迁移利器：Migrator.Net

浏览数：22 / 时间：2015年06月12日

几年前在做项目中第一次接触到了Migrator.Net，就深深被吸引住了，至此以后在新的大项目中，我都会使用Migrator.Net来创建或者更新数据库架构。曾经在项目中也发现了小bug并提交给了作者，当时还是有点小激动啊。几年过去了，Migrator.Net虽然已经迁移到了github上，但作者好像从3年前就不再更新了，不过这不影响我对它的喜爱，一如既往的使用着它，它的出现让我对数据库这块彻底的放开，不用手动去创建表，不用手动的去创建索引，一切就这么简单。

目前Migrator.Net原生代码支持：MsSql，Oracle，PostgreSql，Sqlite，MySql。当然您也可以继承其几个抽象类，完成对其他数据库的支持。使用 Migrator.Net,您可以不用关注使用的是什么类型数据库，数据库之间的迁移也很方便，我们只要关注的是我需要哪些表，哪些字段，哪些索引，哪些关联。

您是否碰到过在项目成熟后，新来的CTO要改变数据库类型，或者重新独立数据库，又或者数据的越来越大，更新更好的数据库呢？这时候作为码农的我们是最头大的时候，因为我可能是在中途接手的项目，也有可能是几年前设计的数据库，鬼知道要做些什么工作啊！为了吃饭，不得不重新研究数据库，不更改数据库类型还好，导出脚本即可，遇到更改数据库类型，天呐~~~有了Migrator.Net，以后您就不需要再有这个担心了，交给他来吧！

准备工作

目前Migrator.Net已经更新至0.9.1版本，您可以通过NuGet管理器下载其相关Dll到您的项目中。最好您也下载其源代码：https://github.com/migratordotnet/Migrator.NET

为了帮助VS2012以前版本的朋友，我打包一下所需的工具及dll，点击下载。

下载源代码后，我们看一下他有3个主项目

Migrator.Framework 我们编写数据库结构时所需要用到的框架

Migrator.Providers 提供了对各个数据库的支持

Migrator 这个就是最终运行升级、回滚操作的类库。

准备工作做好，我们来看下如何创建新表

创建新表

我这次还是用上一篇FluentNhibernate中的数据表，直接看代码，很好理解的：

[Migration(1)] 
      public class _001_AddTable_Store : 
      Migration { public override void 
      Down() { 
      Database.RemoveTable("Store"); } 
      public override void Up() { 
      Database.AddTable("Store", new 
      Column("Id", 
      DbType.Int32, 
      ColumnProperty.PrimaryKeyWithIdentity), 
      new 
      Column("Name", 
      DbType.String, 100, 
      ColumnProperty.NotNull)); } }


折叠代码

我们所有需要Migrator.Net控制的，都需要继承Migration抽象类，实现Down和Up方法，还需要在类特性中使用MigrationAttribute指定版本号。Migrator.Net在运行时，会根据指定的版本号进行升级或者回滚操作。

Migration.Up：版本升级时所需的操作

Migration.Down：版本回滚时所需的操作

Database.AddTable：创建新表

Column：列表类，通过指定列名、类型、长度、列属性创建新列

ColumnProperty：列属性

[Flags] 
      public enum ColumnProperty { None = 
      0, Null = 1, NotNull = 2, Identity = 4, Unique = 8, Indexed = 16, Unsigned 
      = 32, ForeignKey = 33, PrimaryKey = 98, PrimaryKeyWithIdentity = 102, 
      }


折叠代码

对应的都是数据库中列的一些属性，大家应该可以看懂吧

Database.RemoveTable：删除某个表

Up和Down一般都是一一对应的，增加个表，删除个表，增加约束，删除约束等等。

小贴士：建议大家版本号一定要递增，所以在版本类中，我们可以使用“版本号_操作_表名”来命名文件，比如：001_AddTable_Store.cs

接下来我们再创建一个Employee表：

[Migration(2)] 
      public class _002_AddTable_Employee 
      : Migration { private 
      const string tablename = 
      "Employee"; public override void 
      Up() { Database.AddTable(tablename, new 
      Column("Id", 
      DbType.Int32, 
      ColumnProperty.PrimaryKeyWithIdentity), 
      new 
      Column("LastName", 
      DbType.String, 50, 
      ColumnProperty.NotNull), new 
      Column("FirstName", 
      DbType.String,50, 
      ColumnProperty.NotNull), new 
      Column("Store_Id", 
      DbType.Int32, 
      ColumnProperty.NotNull)); 
      Database.AddForeignKey("FK_Employee_Store", 
      "Employee", 
      "Store_Id", "Store", 
      "Id"); } public override void 
      Down() { Database.RemoveForeignKey(tablename, 
      "FK_Employee_Store"); 
      Database.RemoveTable(tablename); } }


折叠代码

在这个版本中，我们使用了Database.AddForeignKey使Employee表与Store表有了关联。除了之前介绍的AddTable和RemoveTable之外，还有以下常用方法：

ITransformationProvider.AddForeignKey 添加关系

ITransformationProvider.RemoveForeignKey 移除关系

ITransformationProvider.AddCheckConstraint 添加约束

ITransformationProvider.AddUniqueConstraint 添加唯一约束

ITransformationProvider.RemoveConstraint 移除约束

ITransformationProvider.AddPrimaryKey 添加主键

ITransformationProvider.AddColumn 添加列

ITransformationProvider.RemoveColumn 移除列

在删除某个表时，请先清除其约束、关系，否则无法删除。

ok，基本了解后，我们来运行一下

运行

你可以自己写个运行程序，使用Migrator类库中的方法，也可以使用作者已经写好的一个控制台程序进行版本控制。项目所在位置：

使用以下命令运行数据迁移：

Migrator.Console.exe SqlServer2005 "Data Source=.;Initial Catalog=MigratorDemo;Integrated Security=SSPI" DataBaseDemo.dll -version 2

蓝色：数据库类型，对应的是Migrator.Providers.Dialect的子类

红色：数据库连接字符串

橙色：程序集文件名

绿色：版本号，如果忽略将会更新到最新版本，通过-version可以升级和回滚操作。

小贴士：为了项目方便，我把命令写在了bat文件里，方便升级和回滚，您可以点击下载我的工具包

在运行前，我们需要用SqlServer Management Studio连接到数据库，创建一个新的数据库：MigratorDemo

运行以上命令，如果一切顺利，您将看到如下界面：

我们看下Migrator.Net在数据库中创建了什么？

除了我们创建的2个表之外，另外还有一个SchemaInfo表，其中记录了所有的版本信息，请不要手动操作该表。

更新Table

很多时候，我们会不断的更新我们的Table，使其适应我们不断变更的项目。以往我们在更新表格的时候，都会去数据库进行操作，为了我们的应用环境，我们都会写成脚本再去更新，现在有了Migrator.Net我们只需要创建一个升级版本，让它帮我们去更新table，就算遇到错误，因为使用了事务控制，在升级中出现问题也会及时回滚。

接下来我们为Employee表格添加年龄字段：

[Migration(3)] 
      public class _003_AddColumn_Employee 
      : Migration { private 
      const string tablename = 
      "Employee"; public override void 
      Up() { Database.AddColumn(tablename, new 
      Column("Age", 
      DbType.Byte, 
      ColumnProperty.NotNull, 0)); 
      } public override void Down() { } }


折叠代码

通过AddColumn添加表，这里注意下，在Down方法中，我并未对应使用RemoveColumn，是因为在项目中，我添加表和添加表字段中间会发生多次数据库操作，在添加字段后，也会对数据库进行多次操作，所以为了数据库数据不遗失，我这里的Down操作没有添加任何动作，这样只当RemoveTable的时候才会删除这个表的所有数据。当然这个也要按照你的实际情况来，不能一概而就的。

红色0是这个字段的默认值，因为有时候添加字段的时候，这个表已经产生数据，而字段又是非可空类型，这时候您必须添加默认值，否则运行会失败。

运行下，我们看下数据库是否相应进行了改变：