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<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")]
    public class Blog
    {
           public int BlogId { get; set; }
        public string Url { get; set; }
    }    
    
    //还可以使用Fluent API 配置,功能实现与上面一样
     modelBuilder.Entity<Blog>().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<Blog>().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<Blog>(eb =>
        {
            eb.Property(b => b.Url).HasColumnType("varchar(200)");
            eb.Property(b => b.Rating).HasColumnType("decimal(5, 2)");
        });

　　2.4 主键

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

　　//将默认的PK_Posts改为了PrimaryKey_BlogId主键约束名
    modelBuilder.Entity<Blog>()
            .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<Blog>()
            .Property(b => b.Created)
            .HasDefaultValueSql("getdate()");

　　2.7 索引

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

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

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

　　参考文献：

　　　　官方文档：EF查询类型

　　　　　　　　   查询类型示例

 　　　　　　　　  关系数据库建模