使用CodeFirst创建并更新数据库

本文涉及的产品
云数据库 RDS MySQL,集群系列 2核4GB
推荐场景:
搭建个人博客
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,高可用系列 2核4GB
简介: 本文主要介绍如何使用CodeFirst模式来新建并更新数据库 在使用Entity Framwork的三种方式(ModelFist、DBFirst、CodeFirst)中,CodeFirst方式书写的代码最为干净。

本文主要介绍如何使用CodeFirst模式来新建并更新数据库

在使用Entity Framwork的三种方式(ModelFist、DBFirst、CodeFirst)中,CodeFirst方式书写的代码最为干净。

至于CodeFist方式的详细优缺点请各位读者自行搜索,这里不多赘述。

1. 使用CodeFirst方式创建数据库

我们新建一个控制台项目,项目中添加两个Model:Author和Blog以及DbContext。 DbContext的添加方式如下:

项目上右键->添加->新建项->ADO.NET Entity Data Model->Empty Code First model

项目代码如下:

 1 //默认生成的数据表名为类名+字母s,这里使用TableAttribute来指定数据表名为T_Authors
 2     [Table("T_Authors")]
 3     public class Author
 4     {
 5         public int Id { set; get; }
 6         public string Name { set; get; }
 7         /*
 8         此处定义了Blog类型的属性,所以要确保Blog类中至少要有一个表示主键的字段,即public int Id { set; get; }。
      否则在生成数据表时会报错:"EntityType 'Blog' has no key defined. Define the key for this EntityType.
9     Blogs: EntityType: EntitySet 'Blogs' is based on type 'Blog' that has no keys defined." 10     */ 11 public virtual ICollection<Blog> Blogs { set; get; } 12 } 13 14 [Table("T_Blogs")] 15 public class Blog 16 { 17 public int Id { set; get; } 18 public string Title { set; get; } 19 public DateTime Time { set; get; } 20 public int AuthorId { set; get; } 21 public virtual Author Author { set; get; } 22 } 23 24 public class MyDbContext: DbContext 25 { 26 public MyDbContext() 27 : base("name=MyDbContext") 28 { 29 } 30 //DbContext会根据配置文件中connectionStrings指定的数据库名称来建立数据库 31 //DbContext根据DbSet属性的类型来创建数据表,这里指定了Author类型的属性,所以会生成T_Authors数据表 32 public virtual DbSet<Author> Authors { set; get; } 33 }

 

CodeFirst方式会根据配置文件中的配置生成数据库,这里小编使用的是MYSQL数据库,配置文件如下:

 1 <!--EF for MYSQL-->
 2  <entityFramework codeConfigurationType="MySql.Data.Entity.MySqlEFConfiguration, MySql.Data.Entity.EF6">
 3     <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework" />
 4     <providers>
 5       <provider invariantName="MySql.Data.MySqlClient" type="MySql.Data.MySqlClient.MySqlProviderServices, MySql.Data.Entity.EF6" />
 6     </providers>
 7   </entityFramework>
 8   <connectionStrings>
 9     <add name="MyDbContext" connectionString="server=localhost;port=3306;database=EF;uid=root;password=root" providerName="System.Data.MySqlClient" />
10   </connectionStrings>

PS:小编使用的是EF6和MYSQL数据库,所以要在项目中添加对Mysql.Data.Entity.EF6以及EntityFrameword 6.0的引用。

到此,我们已经完成生成数据库的工作,接下来在Main方法中写两行代码:

1 using (var db = new MyDbContext())
2 {
3     db.Authors.Add(new Author() { Name = "xfh" });
4     db.SaveChanges();
5 }

 运行程序,我们会发现EF已经为我们建立了数据库,数据库名称为EF(在配置文件中指定)以及数据表T_Authors。

虽然我们没有为DbContext添加Blog类型的属性,但依然创建了数据表T_Blogs,这是因为在Author类中定义了Blog类型的属性,若我们注释掉

 public virtual ICollection<Blog> Blogs { set; get; } ,删除数据库重新生成就会发现不在生成T_Blogs表。在生成T_Authors表的同时,会生成一张名为_migrationhistory表,这张表用于记录我们对于数据库的更新日志,表中的MigrationId字段的值是我们每次执行Migration时所生成的文件名,根据该字段的值我们可以使用命令 Update-Database -TargetMigration:MigrationIdValue 来将数据库恢复到MigrationIdValue所对应的Migration状态,和Git版本控制有点儿像,但这里若将数据库回滚到以前的版本会导致数据的丢失,并且_migrationhistory表也会删除所记录的当前Migration信息。

2. 更新数据库(Code Fist Migration)

现在,我们给Author类增加字属性Email,代码如下:

    [Table("T_Authors")]
    public class Author
    {
        public int Id { set; get; }
        public string Name { set; get; }
        public string Email { set; get; }
        public virtual ICollection<Blog> Blogs { set; get; }
    }

此时,再次运行该应用程序,则将抛出异常

An unhandled exception of type 'System.InvalidOperationException' occurred in EntityFramework.dll
The model backing the 'MyDbContext' context has changed since the database was created. Consider using Code First Migrations to 
update the database (http://go.microsoft.com/fwlink/?LinkId=238269).

异常信息中提示我们数据库创建之后model发生了变化,所以我们需要对数据库进行更新使二者保持一致才能运行程序。

2.1 启用迁移

对于首次迁移需要启用迁移,具体方法是在Packge Manager Console中输入Enable-Migrations命令即可。


命令运行完毕之后我们会看到命令行中的提示信息

这里我们只是启用了迁移,但不是自动迁移。从提示信息中我们可以看到若要启用自动迁移则要删除Migrations文件夹并在Packge Manager Console中输入

Enable-Migrations –EnableAutomaticMigrations命令或者在Migrations文件夹的Configuration.cs文件中设置AutomaticMigrationsEnabled属性为true即可。

Enable-Migrations命令运行完毕之后会在项目中生成如下文件:

Configuration文件 我们可以在此文件中针对上下文配置迁移行为。

InitialCreate文件   因为我们事先让 Code First 自动创建了一个数据库,这个迁移文件中的代码表示数据库中已创建的对象。该文件文件名包含时间戳,这对于排序十分有帮助。如果尚未创建数据库,则不会将此 InitialCreate 迁移添加到项目中。而是,首次调用 Add-Migration 时,用于创建这些表的代码将为新迁移搭建基架。

2.2 更新数据库

启用迁移之后,在Packge Manager Console中继续输入Update-Database命令来更新数据库,但会发现更新失败。

通过上面的提示信息我们可以知道,要想更新数据库需要启用自动迁移或者使用Add-Migration命令来创建迁移文件。

2.2.2 基于代码的迁移

我们在Packge Manager Console中输入命令Add-Migration AddEmail,命令运行完毕后我们会发现Migrations文件夹下已经创建了_AddEmail文件,文件内容如下:

 1 public partial class AddEmail : DbMigration
 2 {
 3     public override void Up()
 4     {
 5         //注意,这里数据表的名称是dbo.T_Blogs和dbo.T_Authors而不是我们指定的
 6         //T_Blogs和T_Authors,我们可以把数据表名称改为T_Blogs和T_Authors
 7         //数据表以dbo开头貌似是SQL SERVER中的命名方式,这里小编使用的是MYSQL
 8         CreateTable(
 9             "dbo.T_Blogs",
10             c => new
11                 {
12                     Id = c.Int(nullable: false, identity: true),
13                     Author_Id = c.Int(),
14                 })
15             .PrimaryKey(t => t.Id)
16             .ForeignKey("dbo.T_Authors", t => t.Author_Id)
17             .Index(t => t.Author_Id);
18         
19         AddColumn("dbo.T_Authors", "Email", c => c.String(unicode: false));
20     }
21     
22     public override void Down()
23     {
24         DropForeignKey("dbo.T_Blogs", "Author_Id", "dbo.T_Authors");
25         DropIndex("dbo.T_Blogs", new[] { "Author_Id" });
26         DropColumn("dbo.T_Authors", "Email");
27         DropTable("dbo.T_Blogs");
28     }
29 }
30     

 

我们可以看到Up方法中调用了AddColumn方法来向数据库中添加Email字段。这时我们在Packge Manager Console中输入命令Update-Database命令(也可以使用Update-Database -Verbose命令,该命令可以使我们看到SQL语句的执行过程,注意-Verbose和-Database之间有个空格)并运行,可以看到命令成功执行,然后到数据库中查看数据表T_Authors发现表中已经添加字段Email,同时数据表__migrationhistory中对于我们的此次更新进行了记录。

对于上述代码我们可以进行简化:

public partial class AddEmail : DbMigration
{
    public override void Up()
    {
        AddColumn("T_Authors", "Email", c => c.String(unicode: false));
    }
    
    public override void Down()
    {
        DropColumn("T_Authors", "Email");
    }
}

我们也可以直接通过创建迁移文件来更新数据库而不修改Model。如:

通过命令Add-Migration addAge来创建一个新的迁移文件,代码如下:

public partial class AddAge : DbMigration
{
    public override void Up()
    {
        AddColumn("T_Authors", "Age", c => c.Int(nullable: false,defaultValue:18));
    }
    
    public override void Down()
    {
        DropColumn("T_Authors", "Age");
    }
}

然后运行命令Update-Database,我们会发现数据库T_Authors表中创建了字段Age。虽然成功的更新了数据库,但会导致程序中的Model和数据表不匹配。

2.2.2  自动迁移 

启用自动迁移的方法前文已经陈述。在启用自动迁移之后,我们再修改Model文件,只需执行Update-Database命令即可完成对数据库的更新。

 

最后再补充一点,在创建数据库之后若修改TableAttribute和ColumnAttribute的值,那么在执行程序时EF会按照TabelAttribute和ColumnAttribute中指定的值和数据库进行匹配,但数据库中并不存在我们新指定的数据表和字段,这会导致程序报错。若我们修改了TableAttribute和ColumnAttribute的值,然后再使用Update-Database命令来更新数据库,数据库会新建一张有TableAttribute指定名称的数据表。

参考文章:

自动化 Code First 迁移

What is Code-First

Code First 迁移

版权声明

本文为作者原创,版权归作者雪飞鸿所有。 转载必须保留文章的完整性,且在页面明显位置处标明原文链接

如有问题, 请发送邮件和作者联系。

相关实践学习
如何在云端创建MySQL数据库
开始实验后,系统会自动创建一台自建MySQL的 源数据库 ECS 实例和一台 目标数据库 RDS。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
目录
相关文章
|
数据库
EF CodeFirst 创建数据库
最近悟出来一个道理,在这儿分享给大家:学历代表你的过去,能力代表你的现在,学习代表你的将来。    十年河东十年河西,莫欺少年穷    学无止境,精益求精    话说EF支持三种模式:Code First   Model First   DataBase First,微软最新的EF框架,也就是EF7舍弃了Model First 和 DataBase First,咱们作为最底层的程序员必须跟着‘党’的走,既然微软都放弃了Model First 和 Database First,那么我们也应当跟着‘党’的路线走,表示坚决拥护‘党’的决定,坚决走Code First路线。
1384 0
|
数据建模 数据库 索引
EF CodeFirst增删改查之‘CRUD’
最近悟出来一个道理,在这儿分享给大家:学历代表你的过去,能力代表你的现在,学习代表你的将来。    十年河东十年河西,莫欺少年穷    学无止境,精益求精    本篇旨在学习EF增删改查四大操作    上一节讲述了EF CodeFirst 创建数据库,本节继续引用上一节的相关类学习EF的CRU...
1219 0
|
数据库
EF CodeFirst 如何通过配置自动创建数据库<当模型改变时>
最近悟出来一个道理,在这儿分享给大家:学历代表你的过去,能力代表你的现在,学习代表你的将来。    十年河东十年河西,莫欺少年穷    学无止境,精益求精    本篇为进阶篇,也是弥补自己之前没搞明白的地方,惭愧惭愧。
1713 0
|
18天前
|
SQL 关系型数据库 MySQL
12 PHP配置数据库MySQL
路老师分享了PHP操作MySQL数据库的方法,包括安装并连接MySQL服务器、选择数据库、执行SQL语句(如插入、更新、删除和查询),以及将结果集返回到数组。通过具体示例代码,详细介绍了每一步的操作流程,帮助读者快速入门PHP与MySQL的交互。
32 1
|
20天前
|
SQL 关系型数据库 MySQL
go语言数据库中mysql驱动安装
【11月更文挑战第2天】
34 4