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查詢類型

　　　　　　　　   查詢類型示例

 　　　　　　　　  關系數據庫建模