asp.net core系列 29 EF模型配置(查询类型,关系数据库建模)

一.查询类型

此功能是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而不是DbSet的属性映射到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().ToView("xx");
      // 实体类型的Blog    参数: view or table。注意如果是视图,更新数据,只能是一个表的视图。
        modelBuilder.Entity().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 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");
asp.net core系列 29 EF模型配置(查询类型,关系数据库建模)_第1张图片
image

 (3) 接下来,我们定义一个查询类来保存数据库视图的结果

public class BlogPostsCount
{
    public string BlogName { get; set; }
    public int PostCount { get; set; }
}

(4) 我们配置中的查询类型在OnModelCreating中使用modelBuilder.QueryAPI。 我们使用标准的 fluent 配置 Api 来配置查询类型的映射:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Query().ToView("View_BlogPostCounts")
        .Property(v => v.BlogName).HasColumnName("Name");
}

(5) 最后,我们可以采用标准方式来查询数据库视图:

var postCounts = BloggingContext.BlogPostCounts.ToList();

二. 关系数据库建模

一般而言,本部分中的配置适用于关系数据库。安装关系数据库提供程序时,下面显示的扩展方法将变为可用,原因在于共享Microsoft.EntityFrameworkCore.Relational包

2.1 表映射

表映射是指(实体与数据表的映射)包括查询的表数据,并将其保存到数据库中。
 按照约定,每个实体都将映射到一个表,该表的名称与DbSet在派生上下文中公开实体的属性相同。例如在EF上下文中公开Blog类型,生成的表名与属性名相同。

    //生成Blogs表名
    public DbSet Blogs { get; set; }
//除了约定还可以使用数据注释,表blogs与实体Blog映射
    [Table("blogs")]
    public class Blog
    {
           public int BlogId { get; set; }
        public string Url { get; set; }
    }    
    
    //还可以使用Fluent API 配置,功能实现与上面一样
     modelBuilder.Entity().ToTable("blogs");
2.2 列映射

按照约定,实体中的每个属性都会映射到表中,具有相同名称的数据字段。还可以使用数据注释或Fluent API 配置:

public class Blog
{
   //数据注释将表Blog的blog_id字段映射到BlogId属性。
    [Column("blog_id")]
    public int BlogId { get; set; }
    public string Url { get; set; }
}
    
//使用Fluent API配置,功能实现与上面一样
 modelBuilder.Entity().Property(b => b.BlogId).HasColumnName("blog_id");
2.3 数据类型

数据类型是指:数据库的数据类型与 CLR 属性类型映射。可以使用数据注释来指定精确的数据类型的列(一般用在code first模式)。

//数据注释的案例
public class Blog
{
    public int BlogId { get; set; }
    [Column(TypeName = "varchar(200)")]
    public string Url { get; set; }
    [Column(TypeName = "decimal(5, 2)")]
    public decimal Rating { get; set; }
}

//Fluent API配置,功能实现与上面一样
modelBuilder.Entity(eb =>
        {
            eb.Property(b => b.Url).HasColumnType("varchar(200)");
            eb.Property(b => b.Rating).HasColumnType("decimal(5, 2)");
        });
2.4 主键

对于每个实体类型的键是引入了主键约束。按照约定,主键名称是PK_,例如Posts 实体中有BlogId属性,那表中主键约束名是PK_Posts。可以使用Fluent API配置数据库中的主键约束的名称。

 //将默认的PK_Posts改为了PrimaryKey_BlogId主键约束名
    modelBuilder.Entity()
            .HasKey(b => b.BlogId)
            .HasName("PrimaryKey_BlogId");
2.5 默认架构

如果对象没有显式配置架构,则默认架构是创建对象的数据库架构。按照约定,数据库提供程序将选择最合适的默认架构。例如,Microsoft SQL Server将使用该dbo模式。无法使用数据注释设置默认架构,可以使用Fluent API指定默认架构。

 -- 修改sqlserver 表默认架构
    ALTER SCHEMA [blogging] TRANSFER dbo.Blogs
    -- 查询表
    select * from [blogging].Blogs
//设置ef core 对应数据库表查询的架构名
      modelBuilder.HasDefaultSchema("blogging");
2.6 默认值

如果插入新行,但未指定列值,可设置一个默认值。不可以使用约定或数据注释提供默认值。可以使用Fluent API 配置默认值.

    //例如插入数据时,设置Created字段取sqlserver的当前时间值。
      modelBuilder.Entity()
            .Property(b => b.Created)
            .HasDefaultValueSql("getdate()");

2.7 索引

关系数据库中的索引映射到相同的概念的 EF core 中的索引。按照约定,索引名为IX__,对于复合索引,下划线分隔的属性名称列表。可以使用Fluent API配置索引的名称。

//设置url索引名称为Index_Url
            modelBuilder.Entity()
            .HasIndex(b => b.Url)
            .HasName("Index_Url");

      //还可以指定索引过滤器
            modelBuilder.Entity()
            .HasIndex(b => b.Url)
            .HasFilter("[Url] IS NOT NULL");

参考文献:

官方文档:EF查询类型

查询类型示例

关系数据库建模

你可能感兴趣的:(asp.net core系列 29 EF模型配置(查询类型,关系数据库建模))