EF Code First Migrations 官方Demo

https://msdn.microsoft.com/en-us/data/jj591621

 

一、建立初始模型和数据库

1、创建一个新的控制台程序 MigrationsDemo 

2、安装最新的 EntityFramework NuGet 程序包

打开程序包管理器控制台 -> 运行命令 Install-Package EntityFramework 

3、创建名为 Model.cs 的文件，代码如下，其中定义了一个组成领域模型的 Blog 类，和一个 EF Code First 上下文类 BlogContext 。

    using System.Data.Entity;
    using System.Collections.Generic;
    using System.ComponentModel.DataAnnotations;
    using System.Data.Entity.Infrastructure;

    namespace MigrationsDemo
    {
        public class BlogContext : DbContext
        {
            public DbSet<Blog> Blogs { get; set; }
        }

        public class Blog
        {
            public int BlogId { get; set; }
            public string Name { get; set; }
        }
    }

4、更改 Program.cs 文件的代码

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;

    namespace MigrationsDemo
    {
        class Program
        {
            static void Main(string[] args)
            {
                using (var db = new BlogContext())
                {
                    db.Blogs.Add(new Blog { Name = "Another Blog " });
                    db.SaveChanges();

                    foreach (var blog in db.Blogs)
                    {
                        Console.WriteLine(blog.Name);
                    }
                }

                Console.WriteLine("Press any key to exit...");
                Console.ReadKey();
            }
        }
    }

5、配置 App.config 中的数据库连接字符串（与本地SqlServer数据库连接）。

<configuration>
  <connectionStrings>
    <add name="BlogContext" connectionString="Data Source=.;Initial Catalog= BlogContext;Integrated Security=True" providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

 6、运行程序，在SqlServer中自动生成数据库。

 

二、实现迁移

向 Blog 类添加 Url 属性

public string Url { get; set; }

如果直接运行程序，会报错。

实现上下文的迁移：打开程序包管理器控制台 -> 运行命令 Enable-Migrations

命令执行后，在项目中生成了一个 Migrations 文件夹，包含两个文件：Configuration 类，InitialCreate迁移。

 

多个模型指向同一个数据库

在 Configuration 文件中，包含了 ContextKey 属性，作为 Code First 模型的唯一识别符。

 

三、生成并运行迁移

Code First 迁移有两个主要命令：

Add-Migration ：基于上次迁移后所作出的改变，搭建接下来的迁移支架。

Update-Database ：将所有的待执行迁移应用到数据库

1、在程序包管理器控制台执行命令 Add-Migration AddBlogUrl  （AddBlogUrl  ：Add-Migration 允许我们给这些迁移命名）。

2、在 Migrations 文件夹中，生成了AddBlogUrl  迁移，如下所示。

namespace MigrationsDemo.Migrations
    {
        using System;
        using System.Data.Entity.Migrations;
        
        public partial class AddBlogUrl : DbMigration
        {
            public override void Up()
            {
                AddColumn("dbo.Blogs", "Url", c => c.String());
            }
            
            public override void Down()
            {
                DropColumn("dbo.Blogs", "Url");
            }
        }
    }

3、执行命令 Update-Database，数据库被更新（Blogs 表中包含了 Url 列）。

 

四、定制迁移

在 Blog 类中添加 Rating 属性

public int Rating { get; set; }

添加一个新的 Post 类

    public class Post
    {
        public int PostId { get; set; }
        [MaxLength(200)]
        public string Title { get; set; }
        public string Content { get; set; }

        public int BlogId { get; set; }
        public Blog Blog { get; set; }
    }

在 Blog 类中添加 Posts 集合，来建立 Blog 和 Post 之间的关系

public virtual List<Post> Posts { get; set; }

执行命令 Add-Migration AddPostClass

但是，我们可能需要做一些改变：

1、为 Posts.Title 列添加唯一索引 （如代码22和29行所示）

2、添加一个不为空的 Blogs.Rating 列 （如代码24行所示设置默认值）

    namespace MigrationsDemo.Migrations
    {
        using System;
        using System.Data.Entity.Migrations;
        
        public partial class AddPostClass : DbMigration
        {
            public override void Up()
            {
                CreateTable(
                    "dbo.Posts",
                    c => new
                        {
                            PostId = c.Int(nullable: false, identity: true),
                            Title = c.String(maxLength: 200),
                            Content = c.String(),
                            BlogId = c.Int(nullable: false),
                        })
                    .PrimaryKey(t => t.PostId)
                    .ForeignKey("dbo.Blogs", t => t.BlogId, cascadeDelete: true)
                    .Index(t => t.BlogId)
                    .Index(p => p.Title, unique: true);

                AddColumn("dbo.Blogs", "Rating", c => c.Int(nullable: false, defaultValue: 3));
            }
            
            public override void Down()
            {
                DropIndex("dbo.Posts", new[] { "Title" });
                DropIndex("dbo.Posts", new[] { "BlogId" });
                DropForeignKey("dbo.Posts", "BlogId", "dbo.Blogs");
                DropColumn("dbo.Blogs", "Rating");
                DropTable("dbo.Posts");
            }
        }
    }

现在，迁移已编辑好，执行命令 Update-Database  –Verbose 

PS：加上 –Verbose 可查看 Code First Migrations 运行的SQL 

 

五、数据移动/定制SQL

添加 Post.Abstract 属性，稍后将从 Content 列中获取数据赋给 Abstract 

public string Abstract { get; set; }

执行命令 Add-Migration

将每一个post中的content 的前100个字符赋给Abstract （如第12行代码所示）

    namespace MigrationsDemo.Migrations
    {
        using System;
        using System.Data.Entity.Migrations;
        
        public partial class AddPostAbstract : DbMigration
        {
            public override void Up()
            {
                AddColumn("dbo.Posts", "Abstract", c => c.String());

                Sql("UPDATE dbo.Posts SET Abstract = LEFT(Content, 100) WHERE Abstract IS NULL");
            }
            
            public override void Down()
            {
                DropColumn("dbo.Posts", "Abstract");
            }
        }
    }

执行命令 Update-Database  –Verbose 

 

六、迁移到特定版本(包括降级)

假设需要把数据库状态还原到运行AddBlogUrl 迁移之后，可以用–TargetMigration

运行 Update-Database –TargetMigration: AddBlogUrl 

这个命令将运行 AddBlogAbstract 和 AddPostClass 的 Down script

如果要一路回滚到空数据库，则可执行 Update-Database –TargetMigration: $InitialDatabase

 

七、获取 SQL 脚本

 执行命令：

Update-Database –Script

Update-Database -Script -SourceMigration: $InitialDatabase -TargetMigration: AddPostAbstract 

如果不指定目标迁移，则使用最新一次迁移；如果不指定源迁移，则使用数据库的当前状态

 

生成幂等脚本（EF6以上）

 从EF6开始，如果指定-SourceMigration $ InitialDatabase，则生成的脚本将为“幂等”。幂等脚本可以将当前处于任何版本的数据库升级到最新版本（如果使用-TargetMigration则指定版本）。生成的脚本包括检查__MigrationsHistory表的逻辑，并仅应用以前未应用的更改。

 

八、程序启动时自动更新（初始化 MigrateDatabaseToLatestVersion）

更改 Configuration.cs 文件，设置 AutomaticMigrationsEnabled = true

    using System.Data.Entity.Migrations;

    internal sealed class Configuration : DbMigrationsConfiguration<MigrationsDemo.BlogContext>
    {
        public Configuration()
        {
            AutomaticMigrationsEnabled = false;
            ContextKey = "MigrationsDemo.BlogContext";
        }

        protected override void Seed(MigrationsDemo.BlogContext context)
        {            
        }
    }

更改 Program.cs 文件，设置 MigrateDatabaseToLatestVersion 

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using System.Data.Entity;
    using MigrationsDemo.Migrations;

    namespace MigrationsDemo
    {
        class Program
        {
            static void Main(string[] args)
            {
                Database.SetInitializer(new MigrateDatabaseToLatestVersion<BlogContext, Configuration>());

                using (var db = new BlogContext())
                {
                    db.Blogs.Add(new Blog { Name = "Another Blog " });
                    db.SaveChanges();

                    foreach (var blog in db.Blogs)
                    {
                        Console.WriteLine(blog.Name);
                    }
                }

                Console.WriteLine("Press any key to exit...");
                Console.ReadKey();
            }
        }
    }