快速入門 - 開始使用 Azure Digital Twins Explorer 中的範例案例

本快速入門是 Azure Digital Twins 的簡介，示範 Azure Digital Twins 如何代表資料，並示範如何與實體建築物的數位對應項圖形互動。 您將使用 Azure 入口網站 和 Azure Digital Twins Explorer，後者是在網頁瀏覽器中將 Azure Digital Twins 資料視覺化並與之互動的工具。

在本快速入門中，您將探討預先建置的範例模型，這些模型會以數位方式定義「建築物」、「樓層」和「房間」的概念，並使用這些模型定義來建立數位對應項，以代表實體建築物的特定樓層和房間。 這些個別對應項會連接到虛擬對應項圖形，以反映彼此的關係，形成範例建築物的完整數位表示方式。 您將使用的圖形會代表包含兩個樓層的建築物，而且每個樓層都包含房間。 圖形會如下列影像所示：

以下是您將用來探索本文中圖形的步驟：

1. 建立 Azure Digital Twins 執行個體，並在 Azure Digital Twins Explorer 中將其開啟。
2. 上傳預先建立的模型和圖形資料，以建立範例案例。 手動新增另一個對應項。
3. 模擬變更 IoT 資料，並查詢圖型來查看結果。
4. 檢閱您在體驗中的學習。

注意

為了簡單起見，本快速入門不會涵蓋從模型化環境內的 IoT 裝置或其他資料來源設定即時資料流程。 若要設定驅動對應項圖形的模擬端對端資料流程，請繼續進行教學課程：連接端對端解決方案。 若要深入了解服務之間的資料流程，以及如何將 Azure Digital Twins 整合到更廣泛的 IoT 解決方案，請參閱資料輸入和輸出。

必要條件

您需要 Azure 訂用帳戶來完成本快速入門。 如果您沒有 Azure 訂用帳戶，請立即建立一個免費帳戶。

您也需要下載快速入門中使用的範例圖形素材。 使用下列指示來下載必要的檔案。 稍後，您將遵循更多指示來將這些檔案上傳至 Azure Digital Twins。

• 模型檔案。 瀏覽至下方的每個連結，以滑鼠右鍵按一下畫面上的任何位置，然後在瀏覽器的右鍵功能表中選取 [另存新檔]。 使用 [另存新檔] 視窗，將檔案儲存在您機器上的某處。

  • Building.json：這是以數位方式定義建築物的模型檔案。 此檔案會指定建築物可以包含樓層。
  • Floor.json：這是以數位方式定義樓層的模型檔案。 該檔案會指定樓層可以包含房間。
  • Room.json：這是以數位方式定義房間的模型檔案。 該檔案有溫度屬性。

• buildingScenario.xlsx：此試算表包含對應項圖形範例的資料，包括五個數位對應項，代表具有樓層和房間的特定建築物。 對應項會以泛型模型為基礎，並與關聯性連接，指出哪些元素彼此包含。 視您的瀏覽器設定而定，選取此連結可能會將 buildingScenario.xlsx 檔案自動下載到您的預設下載位置，或者可能會在包含下載選項的瀏覽器中開啟檔案。 以下是下載選項在 Microsoft Edge 中的樣子：

  

提示

這些檔案來自 GitHub 中的 Azure Digital Twins Explorer 存放庫。 您可以瀏覽存放庫的其他範例檔案、總管程式碼等等。

設定 Azure Digital Twins

使用 Azure Digital Twins 的第一個步驟是建立 Azure Digital Twins 執行個體，用來保存您的所有圖形資料。 在本節中，您將建立服務的執行個體，並在 Azure Digital Twins Explorer 中將其開啟。

建立 Azure Digital Twins 執行個體

在本節中，您會使用 Azure 入口網站 建立 Azure Digital Twins 的新實例。 流覽至入口網站，並使用您的認證登入。

1. 一旦在入口網站中，請從在 Azure 服務首頁功能表中選取 [建立資源] 開始。

   

2. 在搜尋方塊中搜尋 Azure Digital Twins ，然後從結果中選擇 Azure Digital Twins 服務。

   將 [方案] 欄位保留為 Azure Digital Twins，然後選取 [建立] 按鈕以開始建立服務的新執行個體。

   

3. 在設定的 [基本] 索引標籤上填寫欄位，包括您的訂用帳戶、資源群組、新執行個體的資源名稱和區域。 勾選 [指派 Azure Digital Twins 資料擁有者角色] 方塊，讓您自己有權管理執行個體中的資料。

   

   注意

   如果 [指派 Azure Digital Twins 資料擁有者角色] 方塊呈現灰色停用狀態，表示您沒有 Azure 訂用帳戶中的權限來管理使用者對資源的存取權。 您可以繼續在本節中建立執行個體，然後應該先讓具有必要權限的人員在執行個體上為您指派此角色，再完成本快速入門的其餘部分。

   符合此需求的常見角色包括：擁有者、帳戶管理員，或使用者存取管理員與參與者的組合。

4. 選取 [檢閱 + 建立] 以完成您的執行個體建立。

5. 您會看到摘要頁面，其中顯示您輸入的詳細資料。 選取 [建立]，確認並建立執行個體。

這會帶您前往 [概觀] 頁面，以追蹤執行個體的部署狀態。

等候頁面指出您的部署已完成。

在 Azure Digital Twins Explorer 中開啟執行個體

部署完成之後，請使用 [移至資源] 按鈕以瀏覽至入口網站中執行個體的 [概觀] 頁面。

接下來，選取 [開啟 Azure Digital Twins Explorer (預覽)] 按鈕。

這會在新索引標籤中開啟 Azure Digital Twins Explorer。如果這是您第一次使用 Explorer，則會看到摘要說明主要功能的歡迎強制回應。

Azure Digital Twins Explorer 可能會自動連線到您的執行個體。 如果沒有，您會看到下列畫面，要求您指定 Azure Digital Twins URL。 (如果您在畫面上沒看到此方塊，則表示 Azure Digital Twins Explorer 已自動完成此步驟。)

如果您看到此方塊，請將 https:// 輸入至欄位中，後面接著執行個體的主機名稱 (您可以在入口網站的 [概觀] 頁面上找到此名稱)。 這些值合起來組成執行個體 URL。 選取 [儲存] 以連線到您的執行個體。

重要

Azure Digital Twins Explorer 不支援 私人端點。 如果您想要搭配使用 Azure Digital Twins Explorer 搭配使用 Private Link 來停用公用存取的 Azure Digital Twins 實例，您可以在雲端私下部署 Azure Digital Twins Explorer 程式代碼基底。 如須瞭解如何執行此動作，請參閱 Azure Digital Twins Explorer：在雲端中執行。

建置範例案例

接下來，您將使用 Azure Digital Twins Explorer 來設定範例模型和對應項圖形。 首先，您會匯入必要條件一節中下載至您機器的模型檔案和對應項圖形檔案。 然後，您將手動建立另一個對應項來完成案例。

模型

建立 Azure Digital Twins 圖形的第一個步驟是定義您環境的詞彙。 模型是存在於您環境中每個實體類型的廣泛定義。 此範例建築案例包含建築物、樓層和房間，因此您需要一個描述什麼是「建築物」的模型定義、一個描述什麼是「樓層」的模型定義，以及一個描述什麼是「房間」的模型定義。 稍後，您可以建立這些模型執行個體的數位對應項，以代表特定的建築物、樓層和房間。

Azure Digital Twins 的模型是以數位對應項定義語言 (DTDL) 撰寫，這是類似於 JSON-LD 的資料物件語言。 每個模型都會從屬性、關聯性和元件方面來描述單一實體類型。

此快速入門已經為您撰寫了模型檔案。 您已在必要條件一節中下載 Building.json、Floor.json 和 Room.json，現在您將使用 Azure Digital Twins Explorer 將這些檔案上傳至 Azure Digital Twins 執行個體。

上傳模型 (.json 檔案)

在 Azure Digital Twins Explorer 中，遵循下列步驟來上傳「建築物」、「樓層」和「房間」模型 (您稍早下載的 .json 檔案)。

1. 在 [模型] 面板中，選取顯示向上箭號的 [上傳模型] 圖示。

   

2. 在顯示的 [開啟] 視窗中，瀏覽至機器上包含已下載 .json 檔案的資料夾。

3. 選取 [Building.json]、[Floor.json] 和 [Room.json]，然後選取 [開啟] 來一次上傳全部檔案。

Azure Digital Twins Explorer 會將這些模型檔案上傳到您的 Azure Digital Twins 執行個體。 這些模型檔案應該會出現在 [模型] 面板中，並顯示其自訂名稱和完整模型識別碼。

您可以從任一個模型的選項中選取 [檢視模型]，以查看定義每個模型類型的 DTDL 程式碼。

分身和對應項圖形

現在，某些模型定義已上傳至您的 Azure Digital Twins 執行個體，您可以使用這些定義來為環境中的元素建立「數位對應項」。

您解決方案中的每個數位對應項都代表實體環境中的實體。 您可以以相同模型類型為基礎建立許多對應項，例如多個皆使用「房間」模型的房間對應項。 在本快速入門中，您將需要建築物的數位對應項，以及建築物中每個樓層和房間的數位對應項。 這些對應項會透過關聯性在代表完整建築物環境的對應項圖形中連接。

在本節中，您將上傳預先建立的圖形，其中包含建築物對應項、兩個樓層對應項和兩個房間對應項。

匯入圖型 (.xlsx檔案)

在 Azure Digital Twins Explorer 中，遵循下列步驟來匯入範例圖形 (您稍早下載的 .xlsx 檔案)。

1. 在 [對應項圖形] 面板中，選取顯示箭號指向雲端的 [匯入圖形] 圖示。

   

2. 在 [開啟] 視窗中，瀏覽至您稍早下載的 buildingScenario.xlsx 檔案。 此檔案包含範例圖型的對應項和關聯性資料。 選取開啟。

   幾秒後，Azure Digital Twins Explorer 會開啟 [匯入] 視圖，顯示要載入的圖形預覽。

3. 若要完成匯入圖形，請選取圖形預覽面板右上角的 [儲存] 圖示。

   

4. Azure Digital Twins Explorer 會使用上傳的檔案來建立要求的對應項，以及對應項之間的關聯性。 請在確定您看到下列指出匯入成功的對話方塊後再繼續。

   

   選取關閉。

   圖形現在已上傳至 Azure Digital Twins Explorer，[對應項圖形] 面板將會重新載入。 該面板會顯示為空白。

5. 若要查看圖形，請在 [Azure Digital Twins Explorer] 視窗頂端附近的 [查詢總管] 面板中，選取 [執行查詢] 按鈕。

   

此動作會執行預設查詢來選取並顯示所有數位對應項。 Azure Digital Twins Explorer 會從服務中擷取所有對應項和關聯性。 並在 [對應項圖形] 面板中，繪製這些項目所定義的圖形。 現在，您可以看到已上傳的範例案例圖形。

圓形 (圖形「節點」) 代表數位對應項。 線條代表關聯性。 BuildingA 對應項「包含」Floor0 和 Floor1 對應項、Floor0 對應項「包含」Room0，以及 Floor1 對應項「包含」Room1。 如果您使用滑鼠，您可以在圖形中按一下並拖曳來將元素四處移動。

新增另一個對應項

建立數位對應項圖形之後，您可以繼續編輯其結構。 想像此範例建築物的 Floor1 最近又建造了另一個房間。 在本節中，您會將代表新房間讀新對應項新增至圖形。

首先，選取定義您要建立之對應項類型的模型。 在左側的 [模型] 面板中，開啟房間模型的選項功能表。 選取 [建立對應項] 以建立此模型類型的新執行個體。

在 [新增對應項名稱] 中輸入 Room2，然後選取 [儲存]。 這會建立新的數位對應項，而該對應項尚未透過關聯性連接到圖形的其餘部分。

接下來，您將新增關聯性以顯示包含 Room2 的 Floor1。 使用 CTRL/CMD 或 SHIFT 鍵來同時選取圖形中的 Floor1 和 Room2。 選取這兩個對應項後，以滑鼠右鍵按一下 Room2，然後選擇 [新增關聯性]。

這會開啟 [建立關聯性] 對話方塊，此對話方塊與預先填入從 Floor1 到 Room2 的「包含」關聯性詳細資料。 選取儲存。

現在，Room2 會在圖形中連接。 如果您使用滑鼠，您可以在圖形中按一下並拖曳對應項，將其排列成您想要的組態。

檢視對應項屬性

您可以選取對應項，在 [對應項屬性] 面板中查看其屬性及其值的清單。

以下是 Room0 的屬性。 請注意，Room0 的溫度為 70。

以下是 Room1 的屬性。 請注意，Room1 的溫度為 80。

Room2 尚未為其屬性設定值，因為此對應項是手動建立的。 若要設定其屬性值，請編輯欄位，將濕度設為 50，而溫度設為 72。 選取儲存圖示。

查詢變動的 IoT 資料

在 Azure Digital Twins 中，您可以使用 SQL 樣式的 Azure Digital Twins 查詢語言，查詢對應項圖形來回答環境相關問題。 在圖形中查詢對應項的其中一種方式，就是根據其屬性。 根據屬性進行查詢可協助您回答環境中關於極端值或識別極端值的問題。 在完全連線的資料導向案例中，對應項的屬性會經常變更，以回應您環境中感測器 (或其他連接資料來源) 的 IoT 資料。 在本快速入門中，您將手動變更值，以模擬變動的感測器讀數。

從執行查詢開始，查看您環境中有多少對應項的溫度高於 75。 在 [查詢總管] 面板中執行下列查詢。

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

回想一下，在早些時候檢視對應項屬性時，Room0 的溫度讀數為 70，Room1 的溫度讀數為 80，而 Room2 的溫度讀數為 72。 建築和樓層對應項沒有溫度屬性。 因此，只有 Room1 會顯示在此結果中。

提示

查詢中也支援其他比較運算子 (<、>、= 或 !=)。 您可以嘗試將不同的值或不同的對應項屬性插入這些作業中，以嘗試回答您自己的問題。

編輯溫度資料

在完全連接的 Azure Digital Twins 解決方案中，圖形中的對應項會收到來自真實 IoT 裝置和其他資料來源的即時更新，並自動更新其屬性，以與您的實際環境保持同步。 為了簡單起見，在本快速入門中，您將在這裡使用 Azure Digital Twins Explorer，手動將 Room0 的溫度讀數設定為 76。

首先，重新執行下列查詢以選取所有數位對應項。 這會在 [對應項圖形] 面板中再次顯示完整的圖形。

SELECT * FROM DIGITALTWINS

選取 [Room0] 以在 [對應項屬性] 面板中顯示其屬性清單。

將溫度值從 70 變更為 76，然後選取 [儲存] 圖示以更新溫度。

成功更新屬性後，您會看到顯示修補程式碼的 [修補程式資訊] 方塊，這些程式碼會在幕後搭配 Azure Digital Twins API 使用，以進行更新。

關閉修補程式資訊。

查詢以查看新結果

若要看到圖形中反映 Room0 的新溫度，請重新執行稍早的查詢，取得環境中溫度高於 75 的所有對應項。

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

現在，Room0 的溫度已從 70 變更為 76，因此 Room0 和 Room1 應該都會顯示在結果中。

檢閱和情境化學習

在本快速入門中，您已建立 Azure Digital Twins 執行個體，並使用 Azure Digital Twins Explorer 在其中填入範例案例。 您也手動新增了數位對應項。

然後，您探索了圖形，包括...

• 使用查詢來回答有關案例的問題。
• 編輯數位對應項的屬性。
• 再次執行查詢，以查看回應如何因更新而變更。

本練習的目的是要示範如何使用 Azure Digital Twins 圖形來回答有關您環境的問題 (尤其是當環境持續改變時)。

在本快速入門中，您已手動更新溫度。 但在 Azure Digital Twins 中，通常會將數位對應項連接到真實的 IoT 裝置，以根據裝置遙測資料來自動接收更新。 您也可以連接其他資料來源、整合來自不同系統的資料，以及定義自己的邏輯來決定對應項的更新方式。 如此一來，您就可以建立一律反映環境實際狀態的即時圖形。 您可以使用查詢來即時取得環境中所發生情況的相關資訊。

您也可以將 Azure Digital Twins 資料匯出至歷史追蹤、資料分析和 AI 服務，以取得更深入的見解及執行環境模擬。 將 Azure Digital Twins 整合到 IoT 解決方案中，可協助您更有效地追蹤過去、控制當下，以及預測未來。

清除資源

若要在此快速入門之後清理，請根據您要下一步執行的動作，選擇您要移除的 Azure Digital Twins 資源。

• 如果您打算繼續進行 Azure Digital Twins 快速入門及教學課程，您可以將本快速入門中的執行個體重複用於這些文章，因此您不需要將其移除。

• 如果您想要繼續使用本文中的 Azure Digital Twins 執行個體，但清除其所有模型、對應項和關聯性，請執行下列 az dt job deletion CLI 命令：

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  如果您只想要刪除部分元素，可以使用 az dt twin relationship delete、az dt twin delete 和 az dt model delete 命令，選擇性地僅刪除您想要移除的元素。

• 如果您不再需要您的 Azure Digital Twins 執行個體，可以使用 Azure 入口網站將其刪除。

  在入口網站中瀏覽回執行個體的 [概觀] 頁面。 (如果您已關閉該索引標籤，可以在 Azure 入口網站搜尋列中再次搜尋該執行個體的名稱，然後從搜尋結果中選取它。)

  選取 [刪除] 以刪除執行個體，包括其所有模型和對應項。

  

您也可能想要從本機電腦刪除範例專案檔案。

下一步

請移至下一個快速入門，在 3D 環境中將 Azure Digital Twins 案例視覺化。

開始使用 3D Scenes Studio

或者，請跳到教學課程來深入了解 SDK、對應項圖形建立和事件流程設定。

• 撰寫用戶端應用程式的程式碼
• 在 Azure Digital Twins 中建立圖形
• 連接端對端解決方案