📜  Entity Framework-代码优先迁移

📅  最后修改于: 2020-11-21 07:36:48             🧑  作者: Mango


Entity Framework 4.3包括一项新的“代码优先迁移”功能,该功能使您可以随着模型随时间的变化而逐步发展数据库架构。对于大多数开发人员而言,这是对4.1和4.2版本中的数据库初始化程序选项的一项重大改进,该选项要求您在模型更改时手动更新数据库或删除并重新创建它。

  • 在Entity Framework 4.3之前,如果您的数据库中已经有数据(种子数据除外)或现有的存储过程,触发器等,则这些策略用于删除整个数据库并重新创建它,因此您将丢失数据和其他数据库对象。

  • 通过迁移,当模型更改时,它将自动更新数据库模式,而不会丢失任何现有数据或其他数据库对象。

  • 它使用名为MigrateDatabaseToLatestVersion的新数据库初始化程序。

迁移有两种-

  • 自动迁移
  • 基于代码的迁移

自动迁移

实体框架4.3中首次引入了自动迁移。在自动迁移中,您无需在代码文件中手动处理数据库迁移。例如,对于每次更改,您还需要更改您的域类。但是,使用自动迁移,您只需在Package Manager控制台中运行命令即可完成此操作。

让我们看一下自动迁移的以下逐步过程。

使用“代码优先”方法时,您没有用于应用程序的数据库。

在此示例中,我们将以下面的代码所示的3个基本班级开始,例如学生,课程和注册。

public class Enrollment {
   public int EnrollmentID { get; set; }
   public int CourseID { get; set; }
   public int StudentID { get; set; }
   public Grade? Grade { get; set; }
    
   public virtual Course Course { get; set; }
   public virtual Student Student { get; set; }

}

public class Student {
   public int ID { get; set; }
   public string LastName { get; set; }
   public string FirstMidName { get; set; }
   public DateTime EnrollmentDate { get; set; }
    
   public virtual ICollection Enrollments { get; set; }

}

public class Course {
   public int CourseID { get; set; }
   public string Title { get; set; }
   [Index]
   public int Credits { get; set; }
    
   public virtual ICollection Enrollments { get; set; }

}

以下是上下文类。

public class MyContext : DbContext {
   public MyContext() : base("MyContextDB") {}
   public virtual DbSet Courses { get; set; }
   public virtual DbSet Enrollments { get; set; }
   public virtual DbSet Students { get; set; }
}

在运行应用程序之前,您需要启用自动迁移。

步骤1-从工具→NuGet软件包管理器→软件包管理器控制台打开软件包管理器控制台。

步骤2-要启用自动迁移,请在Package Manager控制台中运行以下命令。

PM> enable-migrations -EnableAutomaticMigrations:$true

命令

步骤3-命令成功运行后,它将在项目的“迁移”文件夹中创建一个内部密封的Configuration类,如以下代码所示。

namespace EFCodeFirstDemo.Migrations {

   using System;
   using System.Data.Entity;
   using System.Data.Entity.Migrations;
   using System.Linq;
    
   internal sealed class Configuration : DbMigrationsConfiguration {

      public Configuration() {
         AutomaticMigrationsEnabled = true;
         ContextKey = "EFCodeFirstDemo.MyContext";
      }

      protected override void Seed(EFCodeFirstDemo.MyContext context) {

         //  This method will be called after migrating to the latest version.
         //  You can use the DbSet.AddOrUpdate() helper extension method
         //  to avoid creating duplicate seed data. E.g.

         //  context.People.AddOrUpdate(
            //  p ⇒ p.FullName, 
            //  new Person { FullName = "Andrew Peters" }, 
            //  new Person { FullName = "Brice Lambson" }, 
            //  new Person { FullName = "Rowan Miller" }
         //  );
      }
   }
}

步骤4-使用新的数据库初始化策略MigrateDatabaseToLatestVersion在上下文类中设置数据库初始化程序。

public class MyContext : DbContext {

   public MyContext() : base("MyContextDB") {
      Database.SetInitializer(new MigrateDatabaseToLatestVersion("MyContextDB"));
   }

   public virtual DbSet Courses { get; set; }
   public virtual DbSet Enrollments { get; set; }
   public virtual DbSet Students { get; set; }

}

步骤5-您已设置自动迁移。当您执行应用程序时,当您更改模型时,它将自动进行迁移。

移民

步骤6-如您所见,数据库中还创建了一个系统表__MigrationHistory和其他表。在__MigrationHistory中,自动迁移保留数据库更改的历史记录。

步骤7-当您添加另一个实体类作为域类并执行您的应用程序时,它将在您的数据库中创建表。让我们添加以下StudentLogIn类。

public class StudentLogIn {
   [Key, ForeignKey("Student")]
   public int ID { get; set; }
   public string EmailID { get; set; }
   public string Password { get; set; }
    
   public virtual Student Student { get; set; }
}

步骤8-不要忘记在上下文类中为上述类添加DBSet,如以下代码所示。

public virtual DbSet StudentsLogIn { get; set; }

步骤9-再次运行您的应用程序,您将看到StudentsLogIn表已添加到您的数据库中。

学生登录

上述针对自动迁移的步骤仅适用于您的实体。例如,要添加另一个实体类或删除现有的实体类,它将成功迁移。但是,如果您向实体类添加或删除任何属性,则它将引发异常。

步骤10-要处理属性迁移,您需要在配置类构造函数中设置AutomaticMigrationDataLossAllowed = true。

public Configuration() {
   AutomaticMigrationsEnabled = true;
   AutomaticMigrationDataLossAllowed = true;
   ContextKey = "EFCodeFirstDemo.MyContext";
}

基于代码的迁移

开发新应用程序时,数据模型会频繁更改,并且每次模型更改时,数据模型就会与数据库不同步。您已将实体框架配置为在每次更改数据模型时自动删除并重新创建数据库。当您想对迁移进行更多控制时,基于代码的迁移非常有用。

  • 当您添加,删除或更改实体类或更改DbContext类时,下次运行该应用程序时,它将自动删除现有数据库,创建一个与模型匹配的新数据库,并为它添加测试数据。

  • Code First迁移功能通过启用Code First更新数据库架构而不是删除并重新创建数据库来解决此问题。要部署该应用程序,您必须启用迁移。

这是迁移数据库中的更改的基本规则-

  • 启用迁移
  • 添加迁移
  • 更新数据库

让我们看一下下面的代码库迁移的分步过程。

当您使用代码优先方法时,您没有用于应用程序的数据库。

在此示例中,我们将再次从以下3个基本类开始,例如学生,课程和注册。

public class Enrollment {
   public int EnrollmentID { get; set; }
   public int CourseID { get; set; }
   public int StudentID { get; set; }
   public Grade? Grade { get; set; }
    
   public virtual Course Course { get; set; }
   public virtual Student Student { get; set; }

}

public class Student {
   public int ID { get; set; }
   public string LastName { get; set; }
   public string FirstMidName { get; set; }
   public DateTime EnrollmentDate { get; set; }
    
   public virtual ICollection Enrollments { get; set; }

}

public class Course {
   public int CourseID { get; set; }
   public string Title { get; set; }
   [Index]
   public int Credits { get; set; }
    
   public virtual ICollection Enrollments { get; set; }

}

以下是上下文类。

public class MyContext : DbContext {

   public MyContext() : base("MyContextDB") {
      Database.SetInitializer(new MigrateDatabaseToLatestVersion<
         MyContext, EFCodeFirstDemo.Migrations.Configuration>("MyContextDB"));
   }

   public virtual DbSet Courses { get; set; }
   public virtual DbSet Enrollments { get; set; }
   public virtual DbSet Students { get; set; }

}

步骤1-在运行应用程序之前,您需要启用迁移。

步骤2-从工具→NuGet软件包管理器→软件包管理器控制台打开软件包管理器控制台。

步骤3-迁移已启用,现在通过执行以下命令在您的应用程序中添加迁移。

PM> add-migration "UniDB Schema"

步骤4-成功执行命令后,您将在Migration文件夹中看到一个新文件,该文件的名称是您传递给命令的参数的名称,带有时间戳前缀,如下图所示。

时间戳前缀

步骤5-您可以使用“ update-database”命令创建或更新数据库。

PM> Update-Database -Verbose

“ -Verbose”标志指定在控制台中显示要应用于目标数据库的SQL语句。

步骤6-让我们在学生类中再添加一个属性“ Age”,然后执行更新语句。

public class Student {
   public int ID { get; set; }
   public string LastName { get; set; }
   public string FirstMidName { get; set; }
   public int Age { get; set; }
   public DateTime EnrollmentDate { get; set; }
    
   public virtual ICollection Enrollments { get; set; }

}

当您执行PM→更新数据库–详细时,成功执行命令后,您将看到新列“年龄”已添加到数据库中。

新列时代。

我们建议您逐步执行上述示例,以更好地理解。