asp.net core系列 29 EF模型配置(查詢類型,關(guān)系數(shù)據(jù)庫建模)

一.查詢類型

此功能是EF Core 2.1中的新功能。 EF Core除了實體類型之外,EF Core模型還可以包含查詢類型,這些查詢類型是針對“未映射到實體類型”的數(shù)據(jù)獲取。比如視圖,或只讀數(shù)據(jù)表。

1.1 下面介紹下,查詢類型與實體類型共同與不同點(diǎn):

(1) 可以在OnModelCreating中或通過派生DbContext上的“set”屬性添加到EF Core模型中。

(2) 支持許多相同的映射功能,在關(guān)系數(shù)據(jù)庫上,如繼承映射和導(dǎo)航屬性。也可以配置目標(biāo)數(shù)據(jù)庫對象和列通過 fluent API 方法或數(shù)據(jù)注釋。

但是,它們不同于實體中的類型:

(1) 不需要定義的鍵。
(2) 不會跟蹤DbContext上的更改,因此不會在數(shù)據(jù)庫中插入、更新或刪除。
(3) 永遠(yuǎn)不會由約定發(fā)現(xiàn)。
(4) 僅支持一部分導(dǎo)航映射功能
它們可能永遠(yuǎn)不會作為關(guān)系的主體端(沒有主體實體和依賴實體的關(guān)系)。
它們僅可包含指向的實體的引用導(dǎo)航屬性。
實體不能包含查詢類型的導(dǎo)航屬性。
(5) 在ModelBuilder上使用Query方法而不是Entity方法進(jìn)行尋址。
(6) 是否通過類型DbQuery<T>而不是DbSet<T>的屬性映射到DbContext上。
(7) 映射到使用的數(shù)據(jù)庫對象ToView方法,而非ToTable。
(8) 可以映射到定義查詢。定義查詢是在模型中聲明的輔助查詢,充當(dāng)查詢類型的數(shù)據(jù)。

1.2 查詢類型使用方案(應(yīng)用場景)

(1) 作為返回類型的即席FromSql()查詢。

(2) 映射到數(shù)據(jù)庫視圖。

(3) 映射到不具有定義的主鍵的表。

(4) 映射到模型中定義的查詢。

1.3 映射到數(shù)據(jù)庫對象

查詢類型映射到的數(shù)據(jù)庫對象,通過實現(xiàn)ToView 的fluent API。此ToView方法中指定的數(shù)據(jù)庫對象,從 EF Core 的角度來看是視圖,這意味著它將被視為只讀查詢源和不能作為目標(biāo)的更新、插入或刪除操作(也可以將被視為只讀表)。 相反,對于實體類型,EF Core 假定數(shù)據(jù)庫對象中指定ToTable方法可以視為表或視圖、 意味著它可以用作查詢源,還可以做更新、 刪除和插入操作。

// 查詢類型的Blog ,  參數(shù): view or table.
        modelBuilder.Query<Blog>().ToView("xx");
      // 實體類型的Blog    參數(shù): view or table。注意如果是視圖,更新數(shù)據(jù),只能是一個表的視圖。
        modelBuilder.Entity<Blog>().ToTable("xx");
1.4 案例

下面的示例演示如何使用查詢類型來查詢數(shù)據(jù)庫視圖。完整代碼可查看官方示例(下面有鏈接)。

(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上下文生成一個簡單的數(shù)據(jù)庫視圖,這樣就可以查詢與每個Blog的帖子(Posts)數(shù)

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");
image

 (3) 接下來,我們定義一個查詢類來保存數(shù)據(jù)庫視圖的結(jié)果

public class BlogPostsCount
{
    public string BlogName { get; set; }
    public int PostCount { get; set; }
}

(4) 我們配置中的查詢類型在OnModelCreating中使用modelBuilder.Query<T>API。 我們使用標(biāo)準(zhǔn)的 fluent 配置 Api 來配置查詢類型的映射:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder
        .Query<BlogPostsCount>().ToView("View_BlogPostCounts")
        .Property(v => v.BlogName).HasColumnName("Name");
}

(5) 最后,我們可以采用標(biāo)準(zhǔn)方式來查詢數(shù)據(jù)庫視圖:

var postCounts = BloggingContext.BlogPostCounts.ToList();

二. 關(guān)系數(shù)據(jù)庫建模

一般而言,本部分中的配置適用于關(guān)系數(shù)據(jù)庫。安裝關(guān)系數(shù)據(jù)庫提供程序時,下面顯示的擴(kuò)展方法將變?yōu)榭捎?,原因在于共享Microsoft.EntityFrameworkCore.Relational包

2.1 表映射

表映射是指(實體與數(shù)據(jù)表的映射)包括查詢的表數(shù)據(jù),并將其保存到數(shù)據(jù)庫中。
 按照約定,每個實體都將映射到一個表,該表的名稱與DbSet<TEntity>在派生上下文中公開實體的屬性相同。例如在EF上下文中公開Blog類型,生成的表名與屬性名相同。

    //生成Blogs表名
    public DbSet<Blog> Blogs { get; set; }
//除了約定還可以使用數(shù)據(jù)注釋,表blogs與實體Blog映射
    [Table("blogs")]
    public class Blog
    {
           public int BlogId { get; set; }
        public string Url { get; set; }
    }    
    
    //還可以使用Fluent API 配置,功能實現(xiàn)與上面一樣
     modelBuilder.Entity<Blog>().ToTable("blogs");
2.2 列映射

按照約定,實體中的每個屬性都會映射到表中,具有相同名稱的數(shù)據(jù)字段。還可以使用數(shù)據(jù)注釋或Fluent API 配置:

public class Blog
{
   //數(shù)據(jù)注釋將表Blog的blog_id字段映射到BlogId屬性。
    [Column("blog_id")]
    public int BlogId { get; set; }
    public string Url { get; set; }
}
    
//使用Fluent API配置,功能實現(xiàn)與上面一樣
 modelBuilder.Entity<Blog>().Property(b => b.BlogId).HasColumnName("blog_id");
2.3 數(shù)據(jù)類型

數(shù)據(jù)類型是指:數(shù)據(jù)庫的數(shù)據(jù)類型與 CLR 屬性類型映射??梢允褂脭?shù)據(jù)注釋來指定精確的數(shù)據(jù)類型的列(一般用在code first模式)。

//數(shù)據(jù)注釋的案例
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配置,功能實現(xiàn)與上面一樣
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??梢允褂肍luent API配置數(shù)據(jù)庫中的主鍵約束的名稱。

 //將默認(rèn)的PK_Posts改為了PrimaryKey_BlogId主鍵約束名
    modelBuilder.Entity<Blog>()
            .HasKey(b => b.BlogId)
            .HasName("PrimaryKey_BlogId");
2.5 默認(rèn)架構(gòu)

如果對象沒有顯式配置架構(gòu),則默認(rèn)架構(gòu)是創(chuàng)建對象的數(shù)據(jù)庫架構(gòu)。按照約定,數(shù)據(jù)庫提供程序?qū)⑦x擇最合適的默認(rèn)架構(gòu)。例如,Microsoft SQL Server將使用該dbo模式。無法使用數(shù)據(jù)注釋設(shè)置默認(rèn)架構(gòu),可以使用Fluent API指定默認(rèn)架構(gòu)。

 -- 修改sqlserver 表默認(rèn)架構(gòu)
    ALTER SCHEMA [blogging] TRANSFER dbo.Blogs
    -- 查詢表
    select * from [blogging].Blogs
//設(shè)置ef core 對應(yīng)數(shù)據(jù)庫表查詢的架構(gòu)名
      modelBuilder.HasDefaultSchema("blogging");
2.6 默認(rèn)值

如果插入新行,但未指定列值,可設(shè)置一個默認(rèn)值。不可以使用約定或數(shù)據(jù)注釋提供默認(rèn)值??梢允褂肍luent API 配置默認(rèn)值.

    //例如插入數(shù)據(jù)時,設(shè)置Created字段取sqlserver的當(dāng)前時間值。
      modelBuilder.Entity<Blog>()
            .Property(b => b.Created)
            .HasDefaultValueSql("getdate()");

2.7 索引

關(guān)系數(shù)據(jù)庫中的索引映射到相同的概念的 EF core 中的索引。按照約定,索引名為IX_<type name>_<property name>,對于復(fù)合索引,下劃線分隔的屬性名稱列表??梢允褂肍luent API配置索引的名稱。

//設(shè)置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");

參考文獻(xiàn):

官方文檔:EF查詢類型

查詢類型示例

關(guān)系數(shù)據(jù)庫建模

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容