一.查询类型
此功能是EF Core 2.1中的新功能。 EF Core除了实体类型之外,EF Core模型还可以包含查询类型,这些查询类型是针对“未映射到实体类型”的数据获取。比如视图,或只读数据表。
1.1 下面介绍下,查询类型与实体类型共同与不同点:
(1) 可以在OnModelCreating中或通过派生DbContext上的“set”属性添加到EF Core模型中。
(2) 支持许多相同的映射功能,在关系数据库上,如继承映射和导航属性。也可以配置目标数据库对象和列通过 fluent API 方法或数据注释。
但是,它们不同于实体中的类型:
(1) 不需要定义的键。
(2) 不会跟踪DbContext上的更改,因此不会在数据库中插入、更新或删除。
(3) 永远不会由约定发现。
(4) 仅支持一部分导航映射功能
它们可能永远不会作为关系的主体端(没有主体实体和依赖实体的关系)。
它们仅可包含指向的实体的引用导航属性。
实体不能包含查询类型的导航属性。
(5) 在ModelBuilder上使用Query方法而不是Entity方法进行寻址。
(6) 是否通过类型DbQuery<T>而不是DbSet<T>的属性映射到DbContext上。
(7) 映射到使用的数据库对象ToView方法,而非ToTable。
(8) 可以映射到定义查询。定义查询是在模型中声明的辅助查询,充当查询类型的数据。
1.2 查询类型使用方案(应用场景)
(1) 作为返回类型的即席FromSql()查询。
(2) 映射到数据库视图。
(3) 映射到不具有定义的主键的表。
(4) 映射到模型中定义的查询。
1.3 映射到数据库对象
查询类型映射到的数据库对象,通过实现ToView
的
fluent API。此ToView方法中指定的数据库对象,从 EF Core 的角度来看是视图,这意味着它将被视为只读查询源和不能作为目标的更新、插入或删除操作(也可以将被视为只读表)。 相反,对于实体类型,EF Core 假定数据库对象中指定ToTable
方法可以视为表或视图、 意味着它可以用作查询源,还可以做更新、 删除和插入操作。
// 查询类型的Blog , 参数: view or table. modelBuilder.Query<Blog>().ToView("xx"); // 实体类型的Blog 参数: view or table。注意如果是视图,更新数据,只能是一个表的视图。 modelBuilder.Entity<Blog>().ToTable("xx");
1.4 案例
下面的示例演示如何使用查询类型来查询数据库视图。完整代码可查看官方示例(下面有链接)。
(1)首先定义一个简单的Blog和Post实体类型。
public class Blog { public int BlogId { get; set; } public string Name { get; set; } public string Url { get; set; } public ICollection<Post> Posts { get; set; } } public class Post { public int PostId { get; set; } public string Title { get; set; } public string Content { get; set; } public int BlogId { get; set; } }
(2) 使用BloggingContext上下文生成一个简单的数据库视图,这样就可以查询与每个Blog的帖子(Posts)数
BloggingContext.Database.ExecuteSqlCommand( @"CREATE VIEW View_BlogPostCounts AS SELECT b.Name, Count(p.PostId) as PostCount FROM Blogs b JOIN Posts p on p.BlogId = b.BlogId GROUP BY b.Name");
(3) 接下来,我们定义一个查询类来保存数据库视图的结果
public class BlogPostsCount { public string BlogName { get; set; } public int PostCount { get; set; } }
(4) 我们配置中的查询类型在OnModelCreating中使用modelBuilder.Query<T>
API。 我们使用标准的 fluent 配置 Api 来配置查询类型的映射:
protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder .Query<BlogPostsCount>().ToView("View_BlogPostCounts") .Property(v => v.BlogName).HasColumnName("Name"); }
(5) 最后,我们可以采用标准方式来查询数据库视图:
var postCounts = BloggingContext.BlogPostCounts.ToList();
二. 关系数据库建模
一般而言,本部分中的配置适用于关系数据库。安装关系数据库提供程序时,下面显示的扩展方法将变为可用,原因在于共享Microsoft.EntityFrameworkCore.Relational包
2.1 表映射
表映射是指(实体与数据表的映射)包括查询的表数据,并将其保存到数据库中。
按照约定,每个实体都将映射到一个表,该表的名称与DbSet<TEntity>
在派生上下文中公开实体的属性相同。例如在EF上下文中公开Blog类型,生成的表名与属性名相同。
//生成Blogs表名 public DbSet<Blog> Blogs { get; set; }
//除了约定还可以使用数据注释,表blogs与实体Blog映射 [Table("blogs")]