適用於 Azure Data Studio 的 Azure Cosmos DB for MongoDB 移轉延伸項目（預覽版）

文章
10/07/2024

Azure Cosmos DB for MongoDB 延伸項目，可協助將 MongoDB 工作負載移轉至 Azure Cosmos DB。您可以使用此延伸項目來執行以下動作：

對工作負載執行端對端評定，並找出將工作負載移轉到以 vCore 為基礎的 Azure Cosmos DB for MongoDB 所需採取的必要動作。
使用選取的資料庫和集合來執行移轉作業，以虛擬核心型的 Azure Cosmos DB for MongoDB。

重要

目前此延伸項目不支援下列案例：

來源或目標帳戶已啟用私人端點的移轉。
適用於 RU 型 Azure Cosmos DB for MongoDB 的線上/離線移轉。

如需適用於 MongoDB 虛擬核心 API 的替代解決方案的詳細資訊，請參閱移轉選項。

必要條件

以現有虛擬核心型的 Azure Cosmos DB for MongoDB 帳戶。
- 如果您沒有 Azure 訂用帳戶，請建立免費帳戶。
最新版本的 Azure Data Studio。
執行版本 3.2 或更新版本的 MongoDB。
將防火牆例外狀況新增至來源 MongoDB 和虛擬核心型的 Azure Cosmos DB for MongoDB 目標帳戶，以接受來自全域 Azure 資料中心的連線。
如果您第一次使用資料移轉服務，請確定 Microsoft.DataMigration 資源提供者已在您的訂閱中註冊。

準備

在開始移轉之前，請在實際移動任何資料之前對移轉進行前期規劃和決策。

如需 MongoDB 虛擬核心 API 預先移轉規劃的詳細資訊，請參閱虛擬核心型的 Azure Cosmos DB for MongoDB 的預先移轉步驟。
如需適用於 MongoDB RU 之 API 預先移轉規劃的詳細資訊，請參閱RU 型 Azure Cosmos DB for MongoDB 的預先移轉步驟

在您的訂用帳戶註冊 Microsoft.DataMigration 資源提供者

若要確保您的訂用帳戶中已註冊 Microsoft.DataMigration 資源提供者，您可以遵循以下步驟：

Azure 入口網站︰

前往 Azure 入口網站，然後瀏覽至訂用帳戶。
在左側選單中，選擇「設定」之下的「資源提供者」。
在頂端的搜尋框中搜尋 Microsoft.DataMigration。
如果未註冊，請選取它，然後按下「註冊」按鈕。

Azure CLI：

開啟 Azure Cloud Shell 或本機。
執行下列命令以註冊資源提供者：

az provider register --namespace Microsoft.DataMigration

PowerShell：

開啟 Azure Cloud Shell 或本機的 PowerShell。
執行下列命令以註冊資源提供者：

Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

安裝延伸項目

在開始移轉之前，請先在 Azure Data Studio 中安裝 Azure Cosmos DB for MongoDB 移轉延伸項目。

在 Azure Data Studio 中開啟延伸項目管理員。您可以選取延伸模組圖示，或在「檢視」功能表中選取延伸項目。
在搜尋列中輸入 Cosmos。
選取 [適用於 MongoDB 的 Azure Cosmos 資料庫遷移] 延伸模組，並檢視其詳細資料。
選取 [安裝]。

進行延伸模組設定

安裝延伸模組之後，您可以進行某些延伸模組設定。此為選用步驟。如果未明確設定任何設定，延伸模組會使用預設設定。

移至延伸模組，然後選取 [適用於 MongoDB 的 Azure Cosmos 資料庫遷移]、選取 [管理設定] 圖示，然後選取 [延伸模組設定]。
在此處延伸模組的延伸模組設定下，提供 Assessment path 以變更儲存評定中繼資料的位置。如果保留空白，則會使用預設位置。

連線到 MongoDB 來源

第一次使用延伸項目連接到現有的 MongoDB 來源執行個體。請確定您已準備好來源的連線認證，再開始本章節。

在選單列中找到連接圖示，然後選擇新連接。

在連線窗格中，填寫以下欄位：

	值
連線類型	`Azure Cosmos DB for MongoDB`
連接字串參數	針對現有的來源 MongoDB 執行個體使用連接字串或參數。
伺服器群組	`Default`
名稱 (選擇性)	為此連接提供唯一的名稱

選取 Connect。
在 [連線] 窗格開啟新連線的特色選單。然後選取 [管理]。
選取 [Azure Cosmos DB 移轉]。

執行評估

評定會檢查您目前的 MongoDB 資料資產和使用率。然後，評定功能會產生完整的報告，以協助您識別將工作負載移轉至 Azure Cosmos DB for MongoDB 之前所要採取的必要動作。

找出並流覽至 [儀表板] 索引標籤。然後，選取 [評定及移轉資料庫]。
完成精靈以提供延伸項目的詳細資料，以便執行評定。
1. 在 [評定名稱] 欄位，輸入標題。
2. 從供應項目下拉式功能表選取目標 Azure Cosmos DB for MongoDB 帳戶。
3. 提供 MongoDB 記錄的路徑。
  
  提示
  
  這是選擇性欄位，但指定記錄路徑會導致在集合層級產生更細微的結果。未指定記錄檔資料夾時，此工具會使用 serverStatus 命令的詳細資料來執行評定。
  
  serverStatus 命令僅傳回自上次重新啟動以來的功能使用方式，因此您需要確保自上次伺服器重新啟動以來已經過去了足夠的時間才能取得準確反映實際工作負載的評定。
4. 提供資料評定記錄的路徑。
  
  提示
  
  雖然此欄位是選用，但提供資料評定記錄可以產生更詳細的工作負載深入解析。這些記錄是藉由掃描資料和讀取詳細資訊記錄來取得。在起始移轉評定之前，資料評定會以 CLI 獨立執行，然後在這裡提供產生的 JSON。在這裡下載資料評定 CLI。
5. 選擇 [執行驗證] 來驗證評定輸入。
驗證成功後，選取 [開始評定] 以執行評定。
根據來源伺服器的大小，評定程序可能需要一些時間。等待評定完成後再繼續。
評定完成之後，您現在應該會有評定報告。
在評定報告中，選取執行個體名稱以檢閱整個伺服器的問題清單。選取特定資料庫，以檢視僅適用於所選資料庫的問題。
選取 [下載報表] 以取得合併的可下載報告。
研究評定報告，以確定在 Azure Cosmos DB for MongoDB 順暢移轉工作負載所需的任何動作。在進行下一個步驟之前，請確定會處理評定中報告的所有執行問題。如果有任何未解決的問題，您可以退出該流程並稍後處理。一旦解決問題，您就可以返回並重新啟動評定和移轉程序。

執行移轉

現在，使用評定報告，將您的資料從來源 MongoDB 執行個體移轉至虛擬核心型的 Azure Cosmos DB for MongoDB 帳戶。

在評定報告畫面中，選取您打算移轉的任何資料庫。然後選取下一步。
透過按訂用帳戶和資源群組進行篩選，以選取目標 Azure Cosmos DB for MongoDB 帳戶的清單。然後提供連線到帳戶所需的連線認證。
選取 [測試連接]，以驗證 Azure Cosmos DB for MongoDB 帳戶的認證。選取 [下一步] 以瀏覽至從來源到目標集合的對應。
針對對應清單中的每個集合選擇 [略過] 或 [移轉]。已存在於目標中的集合會自動標示為圖示，並預設設定為 [略過]。選取 [下一步] 以設定 Azure 資料庫移轉服務 (DMS)。

警告

選擇移轉現有集合將覆寫整個集合，導致無法復原的資料遺失。選擇此選項時請謹慎。
從下拉式功能表選擇現有的 Azure 資料庫移轉服務執行個體，或選取「建立新的」以建立新的移轉服務。 Azure 資料庫移轉服務是一項使用雲端基礎結構進行資料傳輸的服務，而不是依賴本機資源，將資料移轉到 Azure 資料平台或從 Azure 資料平台移轉資料的服務。
選取最適合您使用案例的移轉模式。
- 線上移轉會複製收集資料，確保在此過程也複寫更新。此方法的優點是停機時間最短，允許連續運作以實現商務持續性。當進行中的作業很重要時，並且優先考慮減少停機時間時，請使用此選項。
- 離線移轉會在一開始擷取資料庫的快照集，並提供更簡單且可預測的方法。當使用資料庫的靜態複本是可接受的，而且即時更新並非必要時，它運作良好。
選取 [下一步] 以查看移轉摘要。檢閱並確認詳細資料之後，請選取 [建立結構描述] 以在目標帳戶建立資源。
選取 [開始移轉] 以使用選取的移轉服務啟動資料傳輸。
在 [確認設定] 快顯視窗，確認您的防火牆設定是否符合需求。選取確定以確認。