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查询类型

查询类型示例

关系数据库建模