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

　　　　　　　　   查询类型示例