好久没有在博客园更新博客了，如今都换了新公司。前段时间写了关于EF迁移的文档，今天拿出来作为这个系列的一篇吧。
一、Entity Framework 迁移命令（get-help EntityFramework）
Enable-Migrations 启用迁移
Add-Migration 为挂起的Model变化添加迁移脚本
Update-Database 将挂起的迁移更新到数据库
Get-Migrations 获取已经应用的迁移
二、自定义迁移
现有一个Demo，有如下Product模型：
1: public class Product
2: {
3:
4: public int ProductId { get; set; }
5:
6: public string ProductName { get; set; }
7:
8: public decimal Price { get; set; }
9:
10: }
修改Product，添加如下两个属性：
1: public DateTime CreateDate { get; set; }
2:
3: public string Unit { get; set; }
其中，CreateDate和Unit都是必须的。
1. Enable-Migrations
在Package Manager Console中执行Enable-Migrations启动迁移。
执行get-help Enable-Migrations –detailed 查看Enable-Migrations的详细用法。
-ContextTypeName 指定要使用的Context
-EnableAutomaticMigrations 启动自动迁移
-ProjectName 指定搭建的迁移类添加到的项目
-StartUpProjectName 指定使用的配置文件所在的项目
-ConnectionStringName 指定使用配置文件中连接字符串的名称
-ConnectionString 指定使用的连接字符串
-ConnectionProviderName 指定连接字符串的provider名称
-Force 重写迁移配置
本Demo中执行
Enable-Migrations -ProjectName Demo.Domain -StartUpProjectName MigrationsDemo
执行结果是：检测到数据库是由database initializer创建，为现有的数据库搭建初始化迁移脚本。本Demo中是在Demo.Domain项目中创建了一个Migrations文件夹，以及Migrations中的2个文件：Configuration.cs和201311010641361_InitialCreate.cs
Configuration 类。此类允许您针对上下文配置迁移的行为。
InitialCreate 迁移。此迁移已在启用迁移之前生成，因为我们事先让 Code First 自动创建了一个数据库。此基架迁移中的代码表示数据库中已创建的对象。
如果尚未创建数据库，则不会将此 InitialCreate 迁移添加到项目中。而是，首次调用 Add-Migration 时，用于创建这些表的代码将为新迁移搭建基架。
2. Add-Migration
在Package Manager Console中执行Add-Migration搭建挂起的Model变化迁移脚本。
执行get-help Add-Migration –detailed查看Add-Migration的详细用法。
-Name 指定自定义脚本的名称
-Force
-ProjectName
-StartUpProjectName
-ConfigurationTypeName 指定使用的迁移配置
-IgnoreChanges 忽略检测到挂起的model改变，创建一个空的迁移。这个选项可用来为已有的数据库启用迁移创建一个初始的，空的迁移。
-ConnectionStringName 指定使用配置文件中连接字符串的名称
-ConnectionString 指定使用的连接字符串
-ConnectionProviderName 指定连接字符串的provider名称
本Demo中执行
Add-Migration Add_Product_CreateDateAndUnit -ProjectName Demo.Domain
生成的Add_Product_CreateDateAndUnit：
2.1 SQL方法
前面提到CreateDate和Unit都是必须的，像Unit是string类型的，更新到数据库默认值为空，CreateDate默认值为1900/1/1 0:00:00，如下图
如果需要更改CreateDate或Unit的值，可以在Up()中使用Sql方法：
注：更新脚本时，将Unit设为中文，记得加’N’，否则在LocalDB中更新的内容会变成’?’，在SQL Server 2008 R2中没有，无论用什么数据库加上都是一个好习惯！
2.2 IgnoreChanges的使用
如果要映射现有的数据库，可以执行Add-Migration Initial，然后执行 Update-Database
这样就创建了一个初始的迁移。在这个基础上再修改Demo，然后迁移。
3. Update-Database
在Package Manager Console中执行Update-Database将挂起的迁移更新到数据库。
执行get-help Update-Database -detailed查看Add-Migration的详细用法。
-SourceMigration 只有-Script打开时才有效。指定迁移的名称用作更新的起点。忽略则使用最后一次应用的迁移。
-TargetMigration 指定将数据库更新到哪个迁移的名称。
-Script 生成SQL脚本
-Force
-ProjectName
-StartProjectName
- ConfigurationTypeName
-ConnectionStringName 指定使用配置文件中连接字符串的名称
-ConnectionString 指定使用的连接字符串
-ConnectionProviderName 指定连接字符串的provider名称
本Demo中执行
Update-Database -ProjectName Demo.Domain
3.1 迁移到特定版本
上面提到可以使用-TargetMigration开关将数据库迁移到特定的状态。比如，撤销数据库新添加的CreateDate和Unit字段。执行
Update-Database -ProjectName Demo.Domain -TargetMigration:InitialCreate
如果要一直回滚到空数据库，可以使用 Update-Database –TargetMigration:0或-TargetMigration:$InitialDatabase命令。
3.2 生成SQL脚本
生成SQL脚本要使用-Script开关，另外两个比较重要的开关是：-SourceMigration和-TargetMigration。
比如我们要生成InitialCreate到 Add_Product_CreateDateAndUnit的迁移SQL脚本，则执行如下命令：
Update-Database -ProjectName Demo.Domain -Script -SourceMigration:InitialCreate -TargetMigration:Add_Product_CreateDateAndUnit
生成下面的SQL脚本
如果忽略-SourceMigration开关，则使用最后一次应用的迁移作为起点，忽略-TargetMigration，则使用最新迁移作为终点。
4. 应用程序启动时自动升级
通过注册 MigrateDatabaseToLatestVersion 数据库初始值设定项来实现该功能。数据库初始值设定项只是包含用于确保数据库安装正确的某种逻辑。首次在应用程序进程 (AppDomain) 中使用上下文时，将运行此逻辑。
Demo中执行
Database.SetInitializer(new MigrateDatabaseToLatestVersion<OrderContext, Configuration>());
其中Configuration生成的是internal sealed class，不在一个程序集中需要修改成public
三、使用Migrate.exe迁移
将命令行工具migrate.exe复制到包含迁移配置的程序集位置，可以在VS外部进行迁移操作。
在使用 NuGet 安装实体框架时，migrate.exe 位于下载包的 tools 文件夹中。在 <项目文件夹>\packages\EntityFramework.<版本>\tools 中
有了 migrate.exe 之后，需要将其复制到包含迁移的程序集位置。
如果应用程序面向 .NET 4 而不是 4.5，则还需要将 Redirect.config 复制到这个位置，并将其重命名为 migrate.exe.config。这样，migrate.exe 会让正确的绑定重定向能够找到实体框架程序集。
注意：migrate.exe 目前不支持 x64 程序集。
Migrate.exe的使用
migrate.exe /? 显示帮助信息
migrate assembly [configurationType] [/targetMigration]
[/startUpDirectory] [/startUpConfigurationFile]
[/startUpDataDirectory] [/connectionStringName]
[/connectionString] [/connectionProviderName] [/force] [/verbose]
[/?]
Assembly 指定包含迁移配置类型的程序集
[configurationType] 指定迁移配置类型的名称
[connectionProviderName] 指定连接字符的provider
[connectionString] 指定使用的连接字符串
[connectionStringName] 指定配置文件中使用的连接字符串名称
[force] 表示允许自动迁移引起数据丢失
[startUpConfigurationFile] 指定程序的Web.config或App.config
[startUpDataDirectory] 指定当解析包含|DataDirectory|的连接字符串时使用的目录
[targetMigration] 指定迁移到的版本
[verbose] 指定输出执行的SQL和其他信息到控制台
本Demo中执行
migrate Demo.Domain.dll /startUpConfigurationFile="MigrationsDemo.exe.config" /targetMigration=” Add_Product_CreateDateAndUnit” /verbose