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

本文提供如何將 Azure Digital Twins 執行個體完全移至不同 Azure 區域的指導，並複製您需要讓新執行個體與原始專案內容一致的所有項目。

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

必要條件

在您嘗試重新建立 Azure Digital Twins 執行個體之前，請先瀏覽原始執行個體的元件，以清楚了解您需要重新建立的所有部分。

要考慮的一些問題如下：

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

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

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

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

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

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

  • Azure 事件方格、Azure 事件中樞或 Azure 服務匯流排
  • Azure Functions
  • 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 入口網站取得該名稱。

接下來，您將設定新執行個體的資料，讓其成為原始執行個體的副本。

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

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

首先，瀏覽至 Azure 入口網站中新執行個體的Azure Digital Twins Explorer。

將您稍早在本文中已下載的 JSON 檔案匯入至新的執行個體。 您可以遵循將檔案匯入至 Azure Digital Twins Explorer 的 Azure Digital Twins Explorer 指示中的步驟來執行此動作。 這些步驟可讓您將所有模型、對應項和關聯性從原始執行個體上傳至新的執行個體。

若要確認所有項目都已成功上傳，請切換回 [對應項圖表] 索引標籤，然後選取 [查詢總管] 面板中的 [執行查詢] 按鈕，以執行預設查詢，以顯示圖表中的所有對應項和關聯性。 此動作也會重新整理 [模型] 面板中的模型清單。

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

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

重新建立端點和路由

如果您的原始執行個體中具有端點或路由，則必須在新執行個體中重新建立這些端點和路由。 不然，如果您沒有原始執行個體中的任何端點或路由，或不想將其移至新的執行個體，您可以跳至下一節。

否則，請遵循 建立端點 中的步驟，然後 建立路由和篩選。 請記住下列指標：

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

重新連接已連線的資源

如果您有其他已連線到原始 Azure Digital Twins 執行個體的應用程式或 Azure 資源，您必須編輯連線，讓其改為連線到您的新執行個體。 這些資源可能包含您設定搭配使用 Azure Digital Twins 的其他 Azure 服務或個人或公司應用程式。

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

否則，請考慮情節中的已連線資源。 您不需要刪除並重新建立任何已連線的資源。 相反地，您只需要編輯其透過主機名稱連線到 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 執行個體。

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