asp.net core系列 24 EF模型配置(主鍵,生成值,最大長度,並發標記)

一.主鍵

　　鍵用作每個實體實例的主要唯一標識符。 使用關系數據庫時，這會映射到主鍵的概念。 還可以配置不是主鍵的唯一標識符。按照約定，名為 Id 或 <type name>Id 的屬性會配置為實體的鍵。例如下面二個示例：

class Car
{
    //映射到Car表 Id主鍵
    public string Id { get; set; }
}
class Car
{
    //映射到Car表CarId主鍵，約定格式：<type name>Id
    public string CarId { get; set; }
}

　　除了上面講到的約定，還可以用數據注釋將單個屬性配置為實體的鍵，下面示例使用數據注釋配置主鍵

class Car
{
   //映射到Car表LicensePlate主鍵
    [Key]
    public string LicensePlate { get; set; }
}

　　還可以使用 Fluent API 將單個屬性配置為實體的鍵。下面示例使用Fluent API配置主鍵

    class MyContext : DbContext
　　{
   　　 public DbSet<Car> Cars { get; set; }

   　　 protected override void OnModelCreating(ModelBuilder modelBuilder)
   　　 {
        　　modelBuilder.Entity<Car>().HasKey(c => c.LicensePlate);
    　　}
　　}

    class Car
    {
        public string LicensePlate { get; set; }
        public string Make { get; set; }
        public string Model { get; set; }
    }

　　還可以使用 Fluent API 將多個屬性配置為實體的鍵（稱為復合鍵）。 只能使用 Fluent API 配置復合鍵 - 不能使用約定來設置復合鍵，也不能使用數據注釋來配置復合鍵。

class MyContext : DbContext
{
    public DbSet<Car> Cars { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Car>()
            .HasKey(c => new { c.State, c.LicensePlate });
    }
}

 

二.生成的值

　　對於屬性的值生成模式有三種:(1) 無值生成;(2) 在新增時自動生成值;(3) 在添加或更新時自動生成值。下面介紹數據注釋中使用DatabaseGeneratedOption枚舉來實現，說明這三種生成模式的應用場景:

 public class Blog
{
    //沒有值生成, 主鍵一般在數據庫中都是自增，所以在EF中不需要給值
    [DatabaseGenerated(DatabaseGeneratedOption.None)]
    public int BlogId { get; set; }

    //在新增時生成值， 一般插入一條數據時，記錄插入的時間
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public DateTime Inserted { get; set; }
    
    //在新增或修改時生成值， 一般記錄修改的時間。
    [DatabaseGenerated(DatabaseGeneratedOption.Computed)]
    public DateTime LastUpdated { get; set; }
}

　　除了用數據注釋方法生成值，還可以使用Fluent API用於更改某一給定屬性的值生成模式。

    //沒有值生成
    modelBuilder.Entity<Blog>().Property(b => b.BlogId).ValueGeneratedNever();
    //在新增時生成值
    modelBuilder.Entity<Blog>().Property(b => b.Inserted).ValueGeneratedOnAdd();
    //在新增或修改時生成值
    modelBuilder.Entity<Blog>().Property(b => b.LastUpdated).ValueGeneratedOnAddOrUpdate();

 

三. 最大長度

　　最大長度僅適用於數組，數據類型，如 string 和 byte[]。將數據傳遞到提供程序之前，實體框架不會執行任何最大長度驗證。 由提供程序或數據存儲在適當時機進行驗證。以 SQL Server 為目標，超過最大長度將引發異常。

　　使用數據注釋來配置屬性的最大長度。 此示例面向 SQL Server，因此使用數據類型 nvarchar(500)。

public class Blog
{
    public int BlogId { get; set; }
    [MaxLength(500)]
    public string Url { get; set; }
}

　　使用 Fluent API 配置屬性的最大長度。 此示例面向 SQL Server，因此使用數據類型 nvarchar(500)。

    modelBuilder.Entity<Blog>().Property(b => b.Url).HasMaxLength(500);

 

四.並發標記

　　配置並發標記是用於解決數據庫中的並發沖突。數據庫並發：指多個進程或用戶同時訪問或更改數據庫中的相同數據的情況。 並發控制：指的是用於在發生並發更改時確保數據一致性的特定機制。

　　並發標記的實現是通過EF Core來實現並發沖突的解決，而非在數據庫層面的方案。EF Core 實現了樂觀並發控制（非數據庫層面），這意味着它將允許多個進程或用戶獨立進行更改，而不會產生同步或鎖定的開銷。 在理想情況下，這些更改將不會相互干擾，因此都能夠成功。 在最壞的情況下，兩個或更多進程將嘗試進行沖突更改，而其中只有一個進程會成功。

 

　　4.1 並發控制在 EF Core 中的工作原理：

　　　　配置為並發標記的屬性用於實現樂觀並發控制：每當在 SaveChanges 期間執行更新或刪除操作時，會將數據庫上的並發標記屬性值與通過 EF Core 讀取的原始值進行比較：

　　　　(1) 如果這些值匹配，則可以完成該操作。

　　　　(2) 如果這些值不匹配，EF Core 會假設另一個用戶已執行沖突操作，並中止當前事務。這種情況被稱為"並發沖突"。

　　　　當配置好並發標記后，數據庫提供程序負責實現並發標記值的比較，EF Core 會對任何 UPDATE 或 DELETE 語句的 WHERE 子句中的並發標記值進行檢查。執行這些語句后，EF Core 會讀取受影響的行數。如果未影響任何行，將檢測到並發沖突，並且 EF Core 會引發 DbUpdateConcurrencyException。

　　　　例如，將 Person 的 LastName 配置為並發標記。 這樣，對 Person 的任何更新操作(並發標記的屬性必須作為比較參照來反映並發沖突)，都將在 WHERE 子句中做並發檢查，在數據庫端將執行如下sql命令，條件LastName 是EF自動加上去：

　　UPDATE [Person] SET [FirstName] = @p1 WHERE [PersonId] = @p0 AND [LastName] = @p2;

　　　　

　　　　並發標記后會有三組值可用於幫助解決並發沖突：

　　　　　　1.“當前值”是應用程序嘗試寫入數據庫的值。
　　　　　　2.“原始值”是在進行任何編輯之前最初從數據庫中檢索的值。
　　　　　　3.“數據庫值”是當前存儲在數據庫中的值。

 

　　　　產生並發沖突的常規處理步驟是：
　　　　　　1.在 SaveChanges 期間捕獲 DbUpdateConcurrencyException。
　　　　　　2.使用 DbUpdateConcurrencyException.Entries 為受影響的實體准備一組新更改。
　　　　　　3.刷新並發標記的原始值以反映數據庫中的當前值。
　　　　　　4.重試該過程，直到不發生任何沖突。

 

　　下面使用數據注釋方法將LastName屬性配置為並發標記

public class Person
{
    public int PersonId { get; set; }

    [ConcurrencyCheck]
    public string LastName { get; set; }

    public string FirstName { get; set; }
}

　　下面使用Fluent API 可用於將LastName屬性配置為並發標記

 　　modelBuilder.Entity<Person>().Property(p => p.LastName).IsConcurrencyToken();

　　

　　總結：並發沖突的產生，一般只有在生產環境或模擬大量用戶線程的情況下才可能產生關系型數據庫的並發死鎖。產生死鎖的原因有很多，如未建索引導致表掃描、或未按同一順序訪問對象等。只有分析出死鎖的原因( sqlserver 死鎖分析) (mysql死鎖分析)，才考慮結合EF的並發標記來解決。

 

　　參考文獻：

　　　　官方資料： 主鍵

　　　　　　　　    生成的值

　　　　　　　　    最大長度

　　　　　　　　    並發標記