在 KQL 資料庫中檢視實體圖表

在 Real-Time Intelligence 中,您可以檢視 KQL 資料庫專案的譜系和關聯性。 此檢視可讓您以視覺化方式探索資料庫實體之間的關係,並協助您瞭解從來源到目的地的資料流程,提供清晰的圖形表示。 透過使用實體圖,您可以有效地管理資料庫並更深入地了解這些實體如何互動。 這種實體的視覺化表示簡化了資料庫管理並幫助您優化資料結構,從而更輕鬆地追蹤依賴關係並快速採取行動。

如需 Fabric 中工作區譜系的相關資訊,請參閱 譜系。

先決條件

對於想要開啟輸入詳細資料的使用者:

  • 資料庫管理員或資料庫監視器權限,以檢視實體圖中的擷取詳細資料。 如需詳細資訊,請參閱 角色型訪問控制。

開啟實體圖檢視

若要存取檢視,請流覽至您想要的 KQL 資料庫,然後選取 [實體圖]。

顯示實體圖檢視按鈕的螢幕擷取畫面。

您在實體圖視圖中看到了什麼?

當您開啟實體圖檢視時,您會看到 KQL 資料庫中所有專案之間的相依性。

實體圖檢視會顯示下列資訊:

您可以選取項目,以檢視其與資料庫中其他項目的關係。 實體圖會突出顯示與該項目相關的所有項目,並將其餘項目變暗。

數據源

圖中顯示的資料來源包括 Eventstream、Azure 儲存體、Azure 事件中樞 以及 Business Events。 您現在可以看到更多資料來源的詳細資訊,包括其地圖、資料格式、連線狀態以及被攝取的紀錄數量。 如果你不再需要連線,可以直接從實體圖刪除它。

實體圖的截圖,顯示關於資料來源的額外細節。

備註

只有 Eventstreams、Event Hubs、Azure 儲存體 Account 和 Fabric Business Events 會以外部來源的形式出現在實體圖檢視中。 實體圖不會顯示其他外部來源。

篩選實體圖視圖

依實體類型篩選

使用 實體類型 下拉選單篩選器,選擇你想在圖表中顯示的實體類型。 你可以從表格、函式、具體檢視捷徑和資料來源中選擇。 此篩選器幫助您專注於特定實體類型,讓您更容易分析 KQL 資料庫中的關係與相依關係。

實體圖截圖,實體類型過濾器下拉選單開啟。

依攝取時間範圍過濾

使用 「擷取」 下拉選單篩選器,選擇你想要查看擷取細節的時間範圍。 這個篩選器會將資料擷取資訊新增至圖表中相關實體的卡片上,讓你能分析資料流以及資料擷取模式隨時間的變化。

已開啟「攝取時間範圍」篩選器下拉式選單的實體圖螢幕擷圖。

依特定函數或表格篩選

透過從左側導覽窗格選擇特定函數或表格來篩選實體圖檢視。 此篩選器幫助您專注於特定函式或資料表及其相關實體,讓您更容易分析 KQL 資料庫中的關係與相依關係。

實體圖截圖,從左側導覽窗格選取特定函數或表格。

架構違例

模式違規可協助您識別資料庫實體之間的不一致或中斷的引用。 以下是結構描述違規的一些範例:

  • 函數引用不再存在的表或列。
  • 函數引用了另一個不再存在的函數。
  • 函數引用具有不正確數量或類型參數的函數。
  • 函數參照資料類型已變更的資料行。
  • 更新原則會參考不再存在的函數或來源資料表。
  • 更新政策會參考其輸出的結構與目標資料表結構不相符的函數。
  • 無效的擷取對應 (例如,對應中定義的一或多個資料行不存在於目標資料表中)。
  • 無效的連續匯出 (例如找不到參考的資料表或資料行)。
  • 無法連線到外部資料表,因為儲存位置可能不存在,或沒有足夠的權限來存取它。

備註

捷徑在結構描述違規功能中稱為「外部資料表」。

啟用顯示結構違規功能會直接在圖表中高亮受影響的實體。 按一下「模式違規」實例會開啟側面窗格,其中包含有關違規的詳細資訊。

此功能可讓您快速定位並解決損壞的依賴項,確保您的 Eventhouse 資料庫保持一致且可靠。

實體圖的截圖,顯示以紅色標出的架構違規。

您可以在哪些情境中使用實體關係圖?

本節探討您可以在 KQL 資料庫中使用實體圖檢視的各種案例:

主動管理依賴關係

透過沿襲,管理表和函數等實體之間的依賴關係變得簡單。 例如,如果您重新命名資料表或變更其結構描述,您可以立即識別哪些函式在其 KQL 查詢中依賴該資料表。 這種主動方法有助於避免意外問題並確保資料庫結構的無縫更新。

追蹤具體化檢視與來源資料表之間的關聯性

實體圖可讓您追蹤具體化檢視與其基礎來源資料表之間的關聯性。 這使得識別原始資料來源變得簡單,使您能夠更有效地追蹤資料流並排除故障。

與元素互動並採取行動

您可以選取圖表中的任何元素以突出顯示其相關項目,而圖表的其餘部分則變暗,從而更容易專注於特定關係。 針對資料表和外部資料表,在省略符號 [...] 中,您可以選取其他選項,例如查詢資料表、根據資料表建立 Power BI 報表等等。

實體圖表格的螢幕擷取畫面,顯示更多選單。

追蹤記錄匯入

實體圖表可讓您追蹤擷取到每個資料表和具現化檢視中的記錄數。 這種資料流程的清晰檢視可協助您掌握資料匯入的大小和數量,確保您的資料庫正確處理資料。