將數位孿生生成器（預覽）資料連接到 Real-Time 儀錶板

本文將引導您按照步驟，使用 Real-Time 儀錶板 將數位雙胞胎生成器數據（預覽）進行可視化。

這很重要

這項功能目前處於預覽階段。

過程包括下列步驟：

1. 建立 eventhouse 和子 KQL 資料庫 ，以作為 KQL 查詢和儀錶板的數據源。 使用 OneLake 快捷方式 ，讓您的數位對應項產生器數據可在 KQL 資料庫中使用。
2. 建立 Eventhouse 功能 ，以展示您數位雙胞胎建構工具的實體類型和屬性的組織化檢視。 這些函式可讓您更輕鬆地使用數位對應項產生器數據撰寫 KQL 查詢。
3. 查詢 您的資料以取得您需要的深入解析。
4. 將查詢釘選到 資訊主頁 ，然後根據需求持續添加視覺效果。

先決條件

• 已啟用Microsoft網狀架構 容量的 工作區。
• 數位雙胞胎建構器（預覽）專案，與來自 lakehouse 的數據映射。

將數位孿生體生成器（預覽）資料快速載入 KQL 資料庫

當您在數位雙胞胎建構器（預覽） 中對應項目數據時，映射的數據會儲存在新的 Lakehouse 中，其名稱看起來像您的數位雙胞胎建構器項目名稱，後面接著 dtdm。 Lakehouse 位於工作區的根資料夾中。

為了讓 KQL 查詢和 Real-Time 儀錶板能夠存取數據，它必須位於 Eventhouse 的 KQL 資料庫中。

因此，在本節中，您會建立新的 Eventhouse 和子 KQL 資料庫。 然後，您使用 OneLake 快捷方式，將數位雙胞體建構器數據表新增至資料庫。 這個過程使得數位雙胞胎生成器的數據可以在 Eventhouse 中進行查詢。

1. 在您的工作區中建立新的 Eventhouse （如需詳細指示，請參閱 建立 eventhouse）。 Eventhouse 會自動以同名的子 KQL 資料庫建立。

2. 遵循 在 KQL 資料庫中建立 OneLake 快捷方式中的步驟，為您的數位雙胞胎建構器資料湖倉中的所有表格新增捷徑。

   • 選取數據源時，尋找lakehouse，其名稱符合您的數字對應項產生器專案名稱，後面接著 dtdm。

   • 選取要對應的數據表時，請全部選取。 您一次只能新增10個資料表，因此請重複快捷方式建立程式，直到您擁有所有資料表的快捷方式為止。

     

   小提示

   藉由確定 [ 加速 ] 選項在建立快捷方式時切換為 [開啟 ]，即可改善查詢效能。 如需詳細資訊，請參閱 透過 OneLake 快捷方式加速查詢。

3. 完成時，您會在 KQL 資料庫中的快捷方式下看到所有外部數位雙胞胎建構器資料表。

   

建立 Eventhouse 功能

既然您的數字雙胞胎生成器（預覽）資料可在 KQL 資料庫中使用，您可以建立函數，以便更輕鬆地查詢資料。 數字對應項產生器會將其數據儲存在許多數據表中，因此這些函式會組織數據，讓您在撰寫 KQL 查詢時更容易存取數據。

我們提供 網狀架構筆記本 ，其中包含為您建立函式的範例腳本。 文稿會在數位雙生構建者的本體中為每個實體類型和屬性類型組合建立一個函數（例如 Bus_property() 和 Bus_timeseries()）。

設定範例筆記本

請遵循下列步驟，使用範例腳本準備新的筆記本。

1. 從 GitHub 中的範例資料夾下載這些範例成品： digital-twin-builder：

   • 範例筆記本DTB_Generate_Eventhouse_Projection.ipynb
   • 必要的 Python 套件 dtb_samples-0.1-py3-none-any.whl

2. 將筆記本匯入您的 Fabric 工作區。 如需詳細指示，請參閱 建立和使用筆記本 - 匯入現有的筆記本。

3. 將數位雙胞胎構建器資料湖倉新增為筆記本的預設資料來源。 如需詳細指示，請參閱 建立和使用筆記本 - 連接 Lakehouses 和筆記本。

   

4. 選取 lakehouse 名稱旁的 ...，然後選擇 [上傳>]，將 dtb_samples-0.1-py3-none-any.whl 上傳至 Lakehouse 數據源的檔案。

   

   上傳的檔案會在你的湖庫檔案中顯示。

   

5. 在筆記本中，第二個程式碼區塊包含您的數位雙胞胎建構單元名稱和 KQL 資料庫的佔位符。 填入這些佔位符值。

   

現在筆記本已設定並準備好執行。

執行筆記本

依序執行筆記本程式代碼區塊。

筆記本會完成下列作業：

1. 安裝 Python 套件
2. 為您的資源名稱建立變數
3. 使用下列子步驟建立產生投影函式的腳稿：
   1. 連接到您的工作區和數位雙胞胎建構器本體
   2. 設定 Spark 讀取器來從數位孿生構建器資料庫提取資料
   3. 生成腳本，將數位孿生搭建器的數據推送至 Eventhouse
   4. 根據數字對應項產生器的設定自動建立數個函式，讓此數據可在 Eventhouse 中輕鬆存取，以在 KQL 查詢中使用
4. 將您的腳本傳送至網狀架構 REST API，並針對您的 KQL 資料庫執行它

當筆記本運行完畢後，請前往您的 KQL 資料庫，並檢查新的功能。 它們對應到您的實體類型及其配置。

使用 KQL 進行查詢

現在，您可以使用 KQL 查詢中的函式來存取您的數位雙胞胎構建器（預覽）資料。

當您在 KQL 查詢中依名稱呼叫函式時，您可以看到它們所產生的數據投影。 欄位對應到實體類型中的映射屬性。

如需使用 KQL 查詢集查詢資料的相關信息，請參閱 在 KQL 查詢集中查詢數據。

如需存取數字對應項產生器數據的 KQL 查詢範例，請參閱 Real-Time Intelligence 教學課程中的數位對應項產生器第五節： 查詢和可視化數據。

將 Real-Time 儀錶板中的查詢可視化

現在可以使用 KQL 查詢來探索您的數位對應項產生器（預覽）數據，也可以在 Real-Time 儀錶板中加以可視化。

您可以將 KQL 查詢直接從 KQL 查詢集固定到現有或新的儀錶板上。 如需詳細資訊，請參閱 建立 Real-Time 儀錶板 - 從查詢集新增圖格。

您也可以從頭開始建立一個新的儀表板，並運用本文中創建的功能，來撰寫儀表板上版面配置的查詢。 如果您建立新的儀錶板，請務必將 KQL 資料庫新增為儀錶板的數據源。 如需詳細資訊，請參閱 建立 Real-Time 儀錶板。

設定儀錶板之後，請考慮下列動作：

• 設定即時更新的重新整理間隔
• 根據特定條件建立警示
• 與小組成員共用儀錶板
• 探索更進階的KQL 查詢，以從數位孿生構建器（預覽）資料中獲取深入見解

如需使用數位雙胞胎生成器資料的查詢來建立 Real-Time 儀表板的範例，請參閱 Real-Time Intelligence 教學指南中的數位雙胞胎生成器第五節：查詢和可視化資料。

相關內容

• 在 KQL 資料庫中建立 OneLake 快捷方式
• 在 KQL 查詢集中對資料進行查詢。
• 建立即時儀表板