將 Azure Digital Twins 執行個體移至不同的 Azure 區域

本文提供如何完成將 Azure Digital Twins 實例移至不同 Azure 區域的指引，並複製所有專案，讓新的實例符合原始實例。

如果您需要將 Azure Digital Twins 執行個體從某個區域移至另一個區域，目前的流程就是在新區域中重新建立您的資源。 在新的區域中重新建立資源之後，就會刪除原始資源。 在此程序結束時，您有一個新的 Azure Digital Twins 實例，與第一個相同，但更新的位置除外。

必要條件

在重新建立 Azure Digital Twins 實例之前，請先查看原始實例的元件，以清楚瞭解您需要重新建立的所有部分。

要考慮的一些問題如下：

• 上傳至執行個體的模型為何？ 有多少模型？

• 我的執行個體中有哪些對應項？ 有多少模型？

• 執行個體中圖表的一般形狀為何？ 有多少關聯性？

• 我的執行個體中有哪些端點？

• 我的執行個體中有哪些路由？ 其是否具有篩選條件？

• 我的執行個體連線到其他 Azure 服務的位置？ 一些常見的整合點包括：

  • Azure 事件方格、Azure 事件中樞或 Azure 服務匯流排
  • Azure Functions（Microsoft 雲端服務）
  • Azure Logic 應用程式
  • Azure 資料總管
  • Azure 地圖服務
  • Azure IoT 中樞裝置佈建服務

• 有哪些其他個人或公司應用程式可以連線到我的執行個體？

您可以使用 Azure 入口網站、Azure Digital Twins API 和 SDK、Azure Digital Twins CLI 命令或 Azure Digital Twins Explorer來收集此資訊。

下載圖表元素以做好準備

在本節中，您會準備從原始執行個體下載原始模型、對應項及圖表，以重新建立執行個體。 本文針對這項工作使用 Azure Digital Twins Explorer。

注意

您可能已經擁有包含執行個體中模型或圖表的檔案。 若是如此，您就不需要再次下載所有項目，只需要下載您遺漏的部分，或在您最初上傳這些檔案之後可能已變更的項目。 例如，您可能擁有使用新資料更新的對應項。

使用 Azure Digital Twins Explorer 下載模型、對應項及圖表

首先，在 Azure 入口網站中開啟 Azure Digital Twins 執行個體的 Azure Digital Twins Explorer。 若要這樣做，請在入口網站搜尋列中搜尋其名稱，瀏覽至入口網站中的 Azure Digital Twins 執行個體。 接下來，選取 [開啟 Azure Digital Twins Explorer (預覽)] 按鈕。

選取此按鈕會開啟連線至此實例的 Azure Digital Twins Explorer 視窗。

依照 Azure Digital Twins Explorer 指示匯出圖表和模型。 遵循這些指示，可讓您將 JSON 檔案下載到您的電腦，其中包含模型、對應項和關聯性的程式代碼（包括圖形中目前未使用的模型）。

在目的地區域中建立並重新填入新的執行個體

接下來，您會在目標區域中建立新的實例，以完成實例的「移動」。 然後，您會使用原始實例中的數據和元件填入它。

建立新的 執行個體。

首先，在您的目的地區域中建立 Azure Digital Twins 的新執行個體。 遵循設定執行個體和驗證中的步驟。 請記住下列秘訣：

• 如果新的實體位於不同的資源群組中，您可以重複使用原始實例的名稱。 如果新實例與原始實例位於相同的資源群組中，新實例需要它自己的相異名稱。
• 您設定 Azure Digital Twins 實例時，當系統要求您輸入位置，請輸入目標的新區域。

稍後，您需要新實例的主機名稱，以便繼續進行資料設置。 如果您未在安裝期間記下主機名稱，請遵循這些指示立即從Azure 入口網站取得該名稱。

接下來，設定新實例的數據，使其是原始實例的複本。

使用 Azure Digital Twins Explorer 上傳模型、對應項及圖表

在本節中，您可以將模型、對應項及圖表重新載入至新的執行個體。 如果您在原始實例中沒有任何模型、對應項或關聯性，或不想將它們移至新實例，則可以跳至 下一節。

首先，從 Azure 入口網站 導航到新建實例的 Azure Digital Twins Explorer。

將您稍早在本文中已下載的 JSON 檔案匯入至新的執行個體。 如需詳細指示，請參閱 將檔案匯入 Azure Digital Twins Explorer。 這些步驟可讓您將所有模型、對應項和關聯性從原始實例上傳至新的實例。

若要確認所有資料是否已成功上傳，請開啟 雙胞圖 索引標籤，然後在 查詢探索器 面板中選取 執行查詢 按鈕，執行預設查詢，以顯示圖表中所有的雙胞對和關聯性。 此動作也會重新整理 [模型] 面板中的模型清單。

您應該會看到圖表及其所有對應項和關聯性顯示在 [對應項圖表] 面板中。 您也應該會在 [模型] 面板中看到列出的模型。

這些檢視確認您的模型、對應項和圖表已重新載入至目的地區域中的新執行個體。

重新建立端點和路由

如果您的原始實例中有端點或路由，則必須在新實例中重新建立端點。 如果您沒有原始實例中的任何端點或路由，或不想將它們移至新的實例，則可以跳至 下一節。

若要重新建立端點和路由，請遵循 建立端點 中的步驟，然後 建立路由和篩選。 請記住下列秘訣：

• 您不需要重新建立用於端點的事件方格、事件中樞或服務匯流排資源。 您只需要在 Azure Digital Twins 執行個體上重新建立端點。
• 您可以重複使用端點和路由名稱，因為其範圍是不同的執行個體。
• 請記得將任何必要的 篩選 新增至您所建立的路由。

重新連接已連線的資源

如果您有其他已連線到原始 Azure Digital Twins 實例的應用程式或 Azure 資源，您必須編輯連線，以便他們改為存取您的新實例。 這些資源可能包含其他 Azure 服務，或您已設定使用 Azure Digital Twins 的個人或公司應用程式。

如果您沒有任何其他資源連線至原始執行個體，或不想將其移至新的執行個體，您可以跳至下一節。

若要開始重新連結連線的資源，請先識別案例中的已連線資源。 通常您不需要刪除並重新建立已連接的資源，只需要編輯它們通過主機名稱連接到 Azure Digital Twins 實例的連接點。 您必須更新這些點，才能使用新實例的主機名，而不是原始實例。

您需要編輯的確切資源取決於您的解決方案詳細資料，但以下是一些常見的整合點：

• Azure Functions。 如果您有包含原始實例主機名的 Azure 函式，請將此值更新為新實例的主機名，然後重新發佈函式。
• 事件方格、事件中樞或服務匯流排。
• 邏輯應用程式。
• Azure Data Explorer。
• Azure 地圖服務。
• IoT 中樞裝置佈建服務。
• Azure 外部的個人或公司應用程式，例如在程式碼用戶端應用程式中建立的用戶端應用程式，可連線到執行個體並呼叫 Azure Digital Twins API。
• Microsoft Entra 應用程式註冊（不需要重新建立）。 如果您使用應用程式註冊來連線到 Azure Digital Twins API，您可以使用新的執行個體重複使用相同的應用程式註冊。

完成此步驟之後，目標區域中的新實例應該是原始實例的填滿副本。

確認傳輸成功

若要確認您的新執行個體已正確設定，請使用下列工具：

• Azure 入口網站。 入口網站很適合用來確認您的新執行個體確實存在，且位於正確的目的地區域中。 它也適用於驗證端點、路由和其他 Azure 服務的連線。
• Azure Digital Twins CLI 命令。 這些命令很適合用來確認您的新執行個體確實存在，且位於正確的目的地區域中。 其也可以用來驗證執行個體資料。
• Azure Digital Twins Explorer。 Azure Digital Twins Explorer 適用於驗證執行個體資料，例如模型、對應項和圖表。
• Azure Digital Twins API 和 SDK。 這些資源很適合用來驗證執行個體資料，例如模型、對應項及圖表。 其也適合用來驗證端點和路由。

您也可以嘗試執行任何使用原始執行個體執行的自訂應用程式或端對端流程，以協助您確認其是否使用新的執行個體正確運作。

清除來源資源

現在，您的新執行個體已在目的地區域中安裝完成，其中包含原始執行個體資料和連線的副本，您可以刪除執行個體實例。

您可以使用 Azure 入口網站、Azure CLI或控制平面 API。

若要使用 Azure 入口網站刪除執行個體，請在瀏覽器視窗中開啟入口網站，然後藉由在入口網站搜尋列中搜尋名稱來移至原始的 Azure Digital Twins 執行個體。

選取 [刪除] 按鈕，然後依照提示完成刪除。