前提條件

• 自建MongoDB和云數據庫MongoDB支持的版本，請參見遷移方案概覽。
• 建議云數據庫MongoDB的存儲空間比自建MongoDB數據庫占用的存儲空間大10%。

注意事項

• DTS在執行全量數據遷移時將占用源庫和目標庫一定的資源，可能會導致數據庫服務器負載上升。如果數據庫業務量較大或服務器規格較低，可能會加重數據庫壓力，甚至導致數據庫服務不可用。建議您在執行數據遷移前謹慎評估，在業務低峰期執行數據遷移。
• MongoDB實例支持的版本與存儲引擎請參見版本及存儲引擎，如需跨版本或跨引擎遷移，請提前確認兼容性。
• 不支持數據庫admin和local作為源和目標庫。
• 由于DTS寫入數據的邏輯為并發寫入，所以會導致目標端占用的存儲空間比源端大5%~10%。
• 請確保目標端MongoDB沒有與源端相同的主鍵（默認為_id），否則會導致數據丟失。若目標端有與源端相同的主鍵，請在不影響業務的前提條件下清空目標端的相關數據（刪掉目標端中與源端相同_id的文檔）。

費用說明

遷移類型說明

• 全量數據遷移：將源MongoDB數據庫遷移對象的存量數據全部遷移到目標MongoDB數據庫中。
  說明 支持database、collection、index的遷移。
• 增量數據遷移：在全量遷移的基礎上，將源MongoDB數據庫的增量更新數據同步到目標MongoDB數據庫中。
  說明

  • 支持database、collection、index的新建和刪除操作的同步。
  • 支持document的新增、刪除和更新操作的同步。

數據庫賬號的權限要求

數據庫賬號創建及授權方法：

• 阿里云MongoDB實例請參見使用DMS管理MongoDB數據庫用戶。
• 自建MongoDB數據庫請參見MongoDB Create User說明。

操作步驟

1. 登錄數據傳輸控制臺。
2. 在左側導航欄，單擊數據遷移。
3. 在遷移任務列表頁面頂部，選擇目標MongoDB實例所屬地域。
4. 單擊右上角的創建遷移任務。
5. 配置遷移任務的源庫及目標庫信息。

   類別	配置	說明
   無	任務名稱	DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
   源庫信息	實例類型	根據源庫的部署位置進行選擇，本文以有公網IP的自建數據庫為例介紹配置流程。 說明 當自建數據庫為其他實例類型時，您還需要執行相應的準備工作，詳情請參見準備工作概覽。
   	實例地區	當實例類型選擇為有公網IP的自建數據庫時，實例地區無需設置。 說明 如果您的自建數據庫配置了白名單安全類設置，您需要在實例地區配置項后，單擊獲取DTS IP段來獲取DTS服務器的IP地址，并將獲取到的IP地址加入自建數據庫的白名單安全設置中。
   	數據庫類型	選擇MongoDB。
   	主機名或IP地址	填入自建MongoDB數據庫的訪問地址，本案例中填入公網地址。
   	端口	填入自建MongoDB數據庫的服務端口。 說明 本案例中，該服務端口須開放至公網。
   	數據庫名稱	填入鑒權數據庫名，即數據庫賬號所屬的數據庫。
   	數據庫賬號	填入自建MongoDB數據庫的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
   	數據庫密碼	填入該數據庫賬號對應的密碼。 說明 源庫信息填寫完畢后，您可以單擊數據庫密碼后的測試連接來驗證填入的源庫信息是否正確。源庫信息填寫正確則提示測試通過，如提示測試失敗，單擊測試失敗后的診斷，根據提示調整填寫的源庫信息。
   	連接方式	選擇非加密連接。 說明 只有在遷移MongoDB Atlas數據庫時，才能選擇SSL安全連接。
   目標庫信息	實例類型	選擇MongoDB實例。
   	實例地區	選擇目標MongoDB實例所在地域。
   	MongoDB實例ID	選擇目標MongoDB實例ID。
   	數據庫名稱	填入鑒權數據庫名，即數據庫賬號所屬的數據庫。
   	數據庫賬號	填入MongoDB實例的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
   	數據庫密碼	填入該數據庫賬號對應的密碼。 說明 目標庫信息填寫完畢后，您可以單擊數據庫密碼后的測試連接來驗證填入的目標庫信息是否正確。目標庫信息填寫正確則提示測試通過，如提示測試失敗，單擊測試失敗后的診斷，根據提示調整填寫的目標庫信息。

6. 配置完成后，單擊頁面右下角的授權白名單并進入下一步。

   如果源或目標數據庫是阿里云數據庫實例（例如RDS MySQL、云數據庫MongoDB版等），DTS會自動將對應地區DTS服務的IP地址添加到阿里云數據庫實例的白名單；如果源或目標數據庫是ECS上的自建數據庫，DTS會自動將對應地區DTS服務的IP地址添到ECS的安全規則中，您還需確保自建數據庫沒有限制ECS的訪問（若數據庫是集群部署在多個ECS實例，您需要手動將DTS服務對應地區的IP地址添到其余每個ECS的安全規則中）；如果源或目標數據庫是IDC自建數據庫或其他云數據庫，則需要您手動添加對應地區DTS服務的IP地址，以允許來自DTS服務器的訪問。DTS服務的IP地址，請參見DTS服務器的IP地址段。

   警告

   DTS自動添加或您手動添加DTS服務的公網IP地址段可能會存在安全風險，一旦使用本產品代表您已理解和確認其中可能存在的安全風險，并且需要您做好基本的安全防護，包括但不限于加強賬號密碼強度防范、限制各網段開放的端口號、內部各API使用鑒權方式通信、定期檢查并限制不需要的網段，或者使用通過內網（專線/VPN網關/智能網關）的方式接入。

7. 選擇遷移對象及遷移類型。

   配置	說明
   遷移類型	如果只需要進行全量遷移，則勾選全量數據遷移。 如果需要進行不停機遷移，則同時勾選全量數據遷移和增量數據遷移。 說明 如果未勾選增量數據遷移，為保障數據一致性，數據遷移期間請勿在自建MongoDB數據庫中寫入新的數據。
   遷移對象	在遷移對象框中單擊待遷移的對象，然后單擊圖標將其移動到已選擇對象框。 說明 不支持遷移admin、local、config數據庫。 遷移對象選擇的粒度為database、collection或function。 默認情況下，遷移完成后，遷移對象的名稱保持不變。如果您需要改變遷移對象在目標數據庫中的名稱，那么需要使用DTS提供的對象名映射功能。使用方法請參見庫表列映射。
   映射名稱更改	如需更改遷移對象在目標實例中的名稱，請使用對象名映射功能，詳情請參見庫表列映射。
   源、目標庫無法連接重試時間	默認重試12小時，您也可以自定義重試時間。如果DTS在設置的時間內重新連接上源、目標庫，遷移任務將自動恢復。否則，遷移任務將失敗。 說明 由于連接重試期間，DTS將收取任務運行費用，建議您根據業務需要自定義重試時間，或者在源和目標庫實例釋放后盡快釋放DTS實例。

8. 上述配置完成后，單擊頁面右下角的預檢查并啟動。

   說明

   • 在遷移任務正式啟動之前，會先進行預檢查。只有預檢查通過后，才能成功啟動遷移任務。

   • 如果預檢查失敗，單擊具體檢查項后的，查看失敗詳情。

     • 您可以根據提示修復后重新進行預檢查。

     • 如無需修復告警檢測項，您也可以選擇確認屏蔽、忽略告警項并重新進行預檢查，跳過告警檢測項重新進行預檢查。

9. 預檢查通過后，單擊下一步。
10. 在購買配置確認頁面，選擇鏈路規格并勾選數據傳輸（按量付費）服務條款。
11. 單擊購買并啟動，遷移任務正式開始。
    • 全量數據遷移

      請勿手動結束遷移任務，否則可能會導致數據不完整。您只需等待遷移任務完成即可，遷移任務會自動結束。

    • 增量數據遷移

      遷移任務不會自動結束，您需要手動結束遷移任務。

      說明 請選擇合適的時間手動結束遷移任務，例如業務低峰期或準備將業務切換至MongoDB實例時。
      1. 觀察遷移任務的進度變更為增量遷移，并顯示為無延遲狀態時，將源庫停寫幾分鐘，此時增量遷移的狀態可能會顯示延遲的時間。
      2. 等待遷移任務的增量遷移再次進入無延遲狀態后，手動結束遷移任務。
12. 將業務切換至阿里云MongoDB實例。

更多信息

如何連接云數據庫MongoDB副本集實例