第一次使用EntityFramework做CodeFirst的开发,在做数据迁移时遇到不少问题,花费了一整天的时间学习调整,总算时学会了基本用法和要点。现在整理后贴出来,希望对和我一样的初用者能有一些帮助,少走一些弯路,少花一点时间摸索,都是值得的。
- 一. 模型设计
- 1. 遵循EF标准,注意表关系配对
- 2. 数据模型里尽量把必须的属性和说明都写全
- 3. EF默认id字段为主键,如果没有,需指定主键
- 二. 数据迁移
- 1. 命令运行环境:visual studio工具栏->工具->NuGet 程序包管理器->程序包管理器控制台
- 2. 基本命令和常用参数
- > get-help 获取帮助的命令(例:get-help Enable-Migrations –detailed)
- –detailed 详细用法
- > Enable-Migrations 启用迁移
- -Force 强制覆盖
- -ProjectName 目标项目(迁移类所在的项目)
- -StartUpProjectName 启动项目(包含数据库连接字符串配置文件所在的项目)
- -ContextTypeName 需要迁移的数据库(类)
- -ConnectionStringName 指定使用配置文件中连接字符串的名称
- -ConnectionString 指定使用的连接字符串
- -ConnectionProviderName 指定连接字符串的provider名称
- -MigrationsDirectory 指定迁移文件的目录(多个数据库,独立自动迁移用)
- > Add-Migration 为挂起的Model变化添加迁移脚本
- -Force
- -ProjectName
- -StartUpProjectName
- -ConfigurationTypeName 指定使用的迁移配置
- -IgnoreChanges 忽略检测到挂起的model改变,为已有的数据库启用迁移创建一个初始的,空的迁移。
- -ConnectionStringName
- -ConnectionString
- -ConnectionProviderName
- > Update-Database 将挂起的迁移更新到数据库
- -Force
- -ProjectName
- -StartProjectName
- -ConfigurationTypeName
- -ConnectionStringName
- -ConnectionString
- -ConnectionProviderName
- -SourceMigration 只有-Script打开时才有效。指定迁移的名称用作更新的起点。忽略则使用最后一次应用的迁移。
- -TargetMigration 指定将数据库更新到哪个迁移的名称。
- -Script 生成SQL脚本
- > Get-Migrations 获取已经应用的迁移
- 3. 迁移操作步骤举例:
- DataBase :解决方案中,数据模型层项目名称
- Member :解决方案中,启动项的名称
- DataBase.Member.MemberEntities :需要应用数据迁移的数据上下文
- a. 第一次启用迁移,输入命令:
- Enable-Migrations -ProjectName DataBase -StartUpProjectName Member -ContextTypeName DataBase.Member.MemberEntities
- 并敲回车键,然后打开生成的Migrations文件夹中的Configuration.cs文件,
- 把构造方法中的AutomaticMigrationsEnabled = false;改为AutomaticMigrationsEnabled = true;
- 如果有多个数据库,每个库需要独立指定迁移文件,命令格式如下:
- Enable-Migrations -ProjectName DataBase -StartUpProjectName Member -ContextTypeName DataBase.Member.MemberEntities -MigrationsDirectory:MemberMigrations
- b. 模型有改动时,输入命令:add-migration update20150508 -ProjectName DataBase -StartUpProjectName Member -Force并敲回车键,创建迁移脚本
- 然后 输入命令:Update-Database -Verbose -ProjectName DataBase -StartUpProjectName Member并敲回车键,执行迁移操作
- 4. 配置自动迁移
- 在应用程序的入口方法(函数)里注册自动迁移:
- Database.SetInitializer(new MigrateDatabaseToLatestVersion<DataBase.Member.MemberEntities, DataBase.MemberMigrations.Configuration>());
- 注意:Configuration.cs生成的是internal sealed class,如果不在启动程序集中,则需要修改成public
- 5. 脱离visual studio环境做数据库版本迁移,可用migrate.exe,可参考:http://msdn.microsoft.com/zh-cn/data/jj618307
- 三. 注意事项:
- 1. 连接字符串不用DBFirst自动生成的那么复杂,采用如下格式即可:
- <add name="MemberEntities" connectionString="server=.;database=Member;integrated security=true;" providerName="System.Data.SqlClient"/>
- 2. 有挂起的Model改变时,会导致操作不正常,注意操作步骤,必要时清理挂起的迁移。
- 3. 修正后数据库,里面的数据如果需要调整,用Configuration.cs文件里的Seed方法,示例如下:
- protected override void Seed(DataBase.Member.MemberEntities context)
- {
- var users = new List<User>
- {
- new User { Account = "test", Password = "123" },
- new User { Account = "admin", Password = "456" }
- };
- users.ForEach(s => context.Users.AddOrUpdate(p => p.Account, s));
- context.SaveChanges();
- }