asp.net core系列 29 EF模型配置(查詢類型,關係資料庫建模)

一.查詢類型此功能是EF Core 2.1中的新功能。 EF Core除了實體類型之外，EF Core模型還可以包含查詢類型，這些查詢類型是針對“未映射到實體類型”的數據獲取。比如視圖，或只讀數據表。 1.1 下麵介紹下，查詢類型與實體類型共同與不同點： (1) 可以在OnModelCreatin ...

一.查詢類型

　　此功能是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查詢類型

　　　　　　　　查詢類型示例

　　　　　　　　關係資料庫建模