萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

ADO.NET Entity Framework 實體資料模型:實體鍵決定查詢結果唯一性深度解析

問題背景

在 Silverlight RIA Services 專案中,針對資料庫視圖 vw_DesksAndUsers (Join Desk + User 表) 產生實體模型,預期取得多筆使用者-桌位關聯記錄,但實際查詢結果僅保留每個 DeskId 的第一筆,其餘列消失。

根因分析:實體鍵 (EntityKey) 唯一性約束

EF 實體模型要求每個實體類型定義實體鍵 (對應資料表主鍵或唯一鍵)。查詢結果物質化時,EF 依據 EntityKey 進行身分識別合併:

  • 若結果集中有多筆資料擁有相同 EntityKey,EF 視為同一實體,只保留第一筆,後續資料被捨棄。
  • 視圖 vw_DesksAndUsers 無主鍵,EF 向導自動推斷 DeskId、IsPlaying 為實體鍵 (非 Nullable 欄位組合)。
  • 實際資料中 DeskId 重複 (一桌多用戶),導致合併,造成資料遺失。

視圖定義與原始資料

CREATE VIEW vw_DesksAndUsers AS
SELECT d.DeskId, d.IsPlaying, u.UserId, u.UserName, u.Department
FROM Desks d
INNER JOIN Users u ON d.DeskId = u.DeskId;

SQL 查詢結果 (正確):

DeskIdIsPlayingUserIdUserNameDepartment
1True101AliceIT
1True102BobIT
2False201CindyHR

EF 產生的實體類別 (簡化)

public partial class VwDesksAndUser {
    public int DeskId { get; set; }      // EntityKey 成員
    public bool IsPlaying { get; set; }  // EntityKey 成員
    public int UserId { get; set; }
    public string UserName { get; set; }
    public string Department { get; set; }
}

解決方案:修正 EDMX 實體鍵定義

方法一:視圖加入唯一識別欄位 (推薦)

ALTER VIEW vw_DesksAndUsers AS
SELECT d.DeskId, d.IsPlaying, u.UserId, u.UserName, u.Department,
       ROW_NUMBER() OVER (PARTITION BY d.DeskId ORDER BY u.UserId) AS RowNum
FROM Desks d INNER JOIN Users u ON d.DeskId = u.DeskId;
  • 更新 EDMX (右鍵模型介面 → Update Model from Database)。
  • 新欄位 RowNum 為非 Nullable Int,EF 會自動納入 EntityKey (DeskId, IsPlaying, RowNum) → 唯一性滿足,資料完整保留。

方法二:手動調整 EDMX 實體鍵 (不修改資料庫)

  1. 開啟 .edmx 設計介面 (或 XML 編輯器)。
  2. 找到 EntityType Name="VwDesksAndUser" 區塊。
  3. 修改 Key 節點:
<EntityType Name="VwDesksAndUser">
  <Key>
    <PropertyRef Name="DeskId" />
    <PropertyRef Name="IsPlaying" />
    <PropertyRef Name="UserId" />  <!-- 加入 UserId 使鍵唯一 -->
  </Key>
  <Property Name="DeskId" Type="Int32" Nullable="false" />
  <Property Name="IsPlaying" Type="Boolean" Nullable="false" />
  <Property Name="UserId" Type="Int32" Nullable="false" />
  ...
</EntityType>
  1. 重建專案,重新查詢 → 取得完整 3 筆資料。
視圖定義 T-SQL
SQL 查詢正確結果
EDMX 模型圖
錯誤結果:僅保留每 DeskId 第一筆
修改實體鍵屬性視窗
修正後正確結果

核心原理:Identity Map 與 EntityKey

  • ObjectContext 內部維護 Identity Map:Dictionary。
  • 查詢物質化流程:
    1. 執行 SQL 取得 DbDataReader。
    2. 逐列建立實體實例,計算 EntityKey (Key 屬性值組合)。
    3. 檢查 Identity Map:
       • 不存在 → 加入 Map、附加至 Context、回傳新實例。
       • 存在 → 直接回傳現有實例,忽略當前列資料。
  • 因此,EntityKey 必須能唯一識別每一列資料,否則發生「靜默資料遺失」。

最佳實務檢核表

  1. 資料表/視圖必須有主鍵或唯一鍵,EF 才能正確推斷 EntityKey。
  2. 視圖無主鍵時,在 SQL 層加入 ROW_NUMBER/唯一識別欄位,再更新模型。
  3. 若無法修改資料庫,手動編輯 EDMX XML 調整 Key 屬性組合 (需小心維護 SSDL/CSDL/CSL 一致性)。
  4. 使用 AsNoTracking() (EF 4.1+) 可繞過 Identity Map,但失去變更追蹤、導航屬性修復等功能,僅適合唯讀報表。
  5. 定期檢視 EF 產生的 SQL (SQL Profiler / Database.Log),驗證查詢語意。

延伸:EF Core 行為差異

  • EF Core 同樣依賴主鍵進行身分識別合併。
  • 無主鍵實體型別 (Keyless Entity Type, EF Core 3.0+):modelBuilder.Entity().HasNoKey(),查詢不進行合併,但無法追蹤變更、無法導航關聯。
  • 原始 SQL 查詢:context.Set().FromSqlRaw("SELECT ...") 回傳無鍵實體集合。

理解 EntityKey/Identity Map 機制,是避免 EF 查詢「神秘丟列」問題的關鍵。永遠確保實體鍵在查詢結果集中唯一,或明確使用無追蹤查詢。

copyright © 萬盛學電腦網 all rights reserved