最近打算用.NET Core写一份开源的简易CMS系统,来练练手
所以又去深入研究了一下Entity Framework Core
发现其实有些细节园子里还是很少讲到.
特意整理了几个细节.
1.数据库迁移
先了解一下什么是"数据库迁移",它提供了一种方法,可以逐步将Code First的实体架构更改应用于数据库,以保持数据库与EF Core模型同步,同时保留数据库中的现有数据。
EF Core的数据迁移相对EF6来说改了不少也简化了一些.所以我们现在就来看看如何进行数据迁移
我们以官方代码来做为例子..先来创建一个简单的上下文.
public class BloggingContext : DbContext { public BloggingContext() : base() { } private static ILoggerFactory Mlogger => new LoggerFactory(); protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { Mlogger.AddProvider(new MyFilteredLoggerProvider()); var loggerFactory = optionsBuilder .UseMySql(@"链接地址"); } protected override void OnModelCreating(ModelBuilder modelBuilder) { } public DbSet<Blog> Blogs { get; set; } public DbSet<Post> Posts { get; set; } } public class Blog { public int BlogId { get; set; } public string Url { get; set; } public List<Post> Posts { get; set; } } public class Post { public int PostId { get; set; } [MaxLength(50)] public string Title { get; set; } public string Content { get; set; } public int? BlogId { get; set; } public Blog Blog { get; set; } } }
然后我们通过Nuget来添加引用.
Microsoft.EntityFrameworkCore.Tools
打开NuGet包管理控制台
选择默认项目为实体上下文所在的程序集如下:
首先我们需要添加一个迁移版本.
执行命令如下:
Add-Migration BanBen1(这里是版本的名称,可以自己定义)
我们会发现Model程序集下多了一个文件夹为Migrations里面有3个文件.如下:
- XXXXXXXXXXXXX_BanBen1.cs - 主迁移文件。包含应用迁移(in
Up()
)和恢复(inDown()
)所需的操作。 - XXXXXXXXXXXXX_BanBen1.Designer.cs - 迁移元数据文件。包含EF使用的信息。
- BloggingContextModelSnapshot.cs - 当前模型的快照。主要用于确定添加下一次迁移时发生了哪些变化.
然后我们执行命令
Update-Database
如果你的数据库没创建,是第一次,就会执行成功,
如果你前期创建过数据库.但是是第一次创建迁移..就会失败.(注意这里!!)
因为第一次生成的迁移方法是按照新增来迁移的..而不是修改.
错误信息可能会如图:
解决方法是找到XXXXXXXXXXXXX_BanBen1.cs - 主迁移文件,删除Up和Down里面的代码.
删除后如下:
public partial class BanBen1 : Migration { protected override void Up(MigrationBuilder migrationBuilder) { } protected override void Down(MigrationBuilder migrationBuilder) { } }
其实这次迁移就没有修改数据库任何信息..
我们在来创建第二个迁移版本..
首先,我们修改实体类..给Post的Content加上长度限制,如下:
public class Post { public int PostId { get; set; } [MaxLength(50)] public string Title { get; set; } [MaxLength(50)] public string Content { get; set; } public int? BlogId { get; set; } public Blog Blog { get; set; } }
然后我们开始迁移..
记得每次迁移,都需要创建一个迁移版本!
我们执行命令如下(注意,我们的版本已经改为了2):
Add-Migration BanBen2
成功创建迁移文件之后,我们更新数据库.
Update-Database
成功信息如下:
然后我们进入数据库看看效果:
我们发现Content的长度限制已经改为了50
2.删除迁移
有的时候我们刚刚创建了一个迁移,还没应用到数据库,就发现自己需要变更实体.那我们就可以删除这个没有应用的迁移版本.
执行命令如下:(注意,这里是没有应用过的迁移,可以删除.如果应用过了.则会收到错误信息)
Remove-Migration
3.迁移回滚.
有些时候,我们需要回滚到之前的一个迁移版本.,比如我们部署的时候,开发版本和稳定版本肯定不一样..
那么我们就会用到回滚命令.
执行如下:
Update-Database 这里填写需要回滚的版本名
,比如我们执行如下:
Update-Database BanBen1
然后我们会发现,BanBen2中的长度限制,已经没有了..
4.生成一个迁移SQL脚本
有的时候,我们的生产数据库,是需要用脚本来创建库的.所以我们也可以直接通过实体来生成SQL脚本.命令如下:
Script-Migration
就会生成对应的迁移SQL脚本.如下:
CREATE TABLE `__EFMigrationsHistory` ( `MigrationId` varchar(95) NOT NULL, `ProductVersion` varchar(32) NOT NULL, CONSTRAINT `PK___EFMigrationsHistory` PRIMARY KEY (`MigrationId`) ); INSERT INTO `__EFMigrationsHistory` (`MigrationId`, `ProductVersion`) VALUES ('20180316015722_BanBen1', '2.0.2-rtm-10011'); ALTER TABLE `Posts` MODIFY COLUMN `Content` varchar(50) NULL; ALTER TABLE `Posts` ALTER COLUMN `Content` DROP DEFAULT; INSERT INTO `__EFMigrationsHistory` (`MigrationId`, `ProductVersion`) VALUES ('20180316022508_BanBen2', '2.0.2-rtm-10011');
当然,这个脚本可以自定义需要迁移的版本号.文件名,需要生成迁移脚本的上下文(多个上下文的情况).
5.迁移脚本的帮助说明.
我们可以通过命令来获取帮助说明
Get-Help about_EntityFrameworkCore
get-help Add-Migration -full
get-help Script-Migration -full
.