注意事項

• DTS在執行全量數據遷移時將占用源庫和目標庫一定的資源，可能會導致數據庫服務器負載上升。如果數據庫業務量較大或服務器規格較低，可能會加重數據庫壓力，甚至導致數據庫服務不可用。建議您在執行數據遷移前謹慎評估，在業務低峰期執行數據遷移。

• 不支持遷移admin和local數據庫。

• config數據庫屬于系統內部數據庫，如無特殊需求，請勿遷移該庫。

• 阿里云MongoDB實例支持的版本與存儲引擎請參見版本及存儲引擎，如需跨版本或跨引擎遷移，請提前確認兼容性。

• 由于DTS寫入數據的邏輯為并發寫入，所以會導致目標端占用的存儲空間比源端大5%~10%。

• 請確保目標端MongoDB沒有與源端相同的主鍵（默認為_id），否則會導致數據丟失。若目標端有與源端相同的主鍵，請在不影響業務的前提條件下清空目標端的相關數據（刪掉目標端中與源端相同_id的文檔）。

費用說明

遷移類型說明

數據庫賬號的權限要求

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

• MongoDB Atlas數據庫請參見MongoDB Create User說明。

• 阿里云MongoDB實例請參見使用DMS管理MongoDB數據庫用戶。

準備工作

1. 登錄MongoDB Atlas數據庫控制臺。

2. 在左側導航欄，單擊Network Access。

3. 在IP Access List頁簽，單擊Add IP Address。

4. 將對應地區DTS服務的IP地址添加到安全規則中，更多信息請參見添加IP地址和添加DTS服務器的IP地址段。

   說明

   執行此步驟將允許DTS訪問您的MongoDB Atlas數據庫，遷移完成后請刪除該規則。

操作步驟（新版控制臺）

1. 進入目標地域的遷移任務列表頁面（二選一）。

   通過DTS控制臺進入

   1. 登錄數據傳輸服務DTS控制臺。

   2. 在左側導航欄，單擊數據遷移。

   3. 在頁面左上角，選擇遷移實例所屬地域。

   通過DMS控制臺進入

   說明

   實際操作可能會因DMS的模式和布局不同，而有所差異。更多信息。請參見極簡模式控制臺和自定義DMS界面布局與樣式。

   1. 登錄DMS數據管理服務。

   2. 在頂部菜單欄中，選擇集成與開發 > 數據傳輸（DTS） > 數據遷移。

   3. 在遷移任務右側，選擇遷移實例所屬地域。

2. 單擊創建任務，配置源庫及目標庫信息。

   警告

   選擇源和目標實例后，建議您仔細閱讀頁面上方顯示的使用限制，否則可能會導致任務失敗或數據不一致。

   類別	配置	說明
   無	任務名稱	DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
   源庫信息	選擇已有連接信息	您可以按實際需求，選擇是否使用已有實例。 如使用已有實例，下方數據庫信息將自動填入，您無需重復輸入。 如不使用已有實例，您需要輸入下方的數據庫信息。
   	數據庫類型	選擇MongoDB。
   	接入方式	選擇公網IP。
   	實例地區	選擇MongoDB Atlas數據庫所屬地域。 說明 若選項中沒有MongoDB Atlas數據庫所屬的地域，您可以選擇一個該數據庫距離最近的地域。
   	架構類型	選擇副本集架構。
   	域名或IP地址	填入MongoDB Atlas數據庫中，PRIMARY節點的訪問地址。 說明 您可以在MongoDB Atlas控制臺中獲取。
   	端口	填入MongoDB Atlas的服務端口，默認為27017。
   	鑒權數據庫名稱	填入MongoDB Atlas的鑒權數據庫名稱，即數據庫賬號所屬的數據庫。
   	數據庫賬號	填入MongoDB Atlas的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
   	數據庫密碼	填入該數據庫賬號對應的密碼。
   	連接方式	選擇Mongo Atlas SSL。
   目標庫信息	選擇已有連接信息	您可以按實際需求，選擇是否使用已有實例。 如使用已有實例，下方數據庫信息將自動填入，您無需重復輸入。 如不使用已有實例，您需要輸入下方的數據庫信息。
   	數據庫類型	選擇MongoDB。
   	接入方式	選擇云實例。
   	實例地區	選擇目標阿里云MongoDB實例所屬地域。
   	架構類型	根據您的業務需求選擇架構，取值為： 副本集架構：通過部署多種節點來達到高可用和讀寫分離的效果，詳細信息，請參見副本集架構。 分片集群架構：提供Mongos、Shard和ConfigServer三種組件，可自由選擇Mongos和Shard的個數和配置，詳細信息，請參見分片集群架構。
   	實例ID	選擇目標阿里云MongoDB實例ID。
   	鑒權數據庫名稱	填入鑒權數據庫名，即數據庫賬號所屬的數據庫。 說明 如果使用的數據庫賬號為root，那么對應的數據庫名稱即為admin。
   	數據庫賬號	填入目標阿里云MongoDB實例的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
   	數據庫密碼	填入該數據庫賬號對應的密碼。

3. 配置完成后，單擊頁面下方的測試連接以進行下一步。

4. 如果您的自建數據庫具備白名單安全設置，您需要復制彈跳框中的DTS服務器IP地址，并加入自建數據庫的白名單安全設置中。然后單擊測試連接。

   警告

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

5. 配置任務對象及高級配置。

   配置	說明
   遷移類型	如果只需要進行全量遷移，請同時選中庫表結構遷移和全量遷移。 如果需要進行不停機遷移，請同時選中庫表結構遷移、全量遷移和增量遷移。 說明 如果未選擇增量遷移，為保障數據一致性，數據遷移期間請勿在源實例中寫入新的數據。
   目標已存在表的處理模式	預檢查并報錯攔截：檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合，則通過該檢查項目；如果目標數據庫中有同名的集合，則在預檢查階段提示錯誤，數據同步任務不會被啟動。 說明 如果目標庫中同名的集合不方便刪除或重命名，您可以更改該集合在目標庫中的名稱，詳情請參見設置同步對象在目標實例中的名稱。 忽略報錯并繼續執行：跳過目標數據庫中是否有同名集合的檢查項。 警告 選擇為忽略報錯并繼續執行，可能導致數據不一致，給業務帶來風險，例如： 在目標庫遇到與源庫主鍵的值相同的記錄，則會保留目標庫中的該條記錄，即源庫中的該條記錄不會同步至目標庫中。 可能會導致無法初始化數據、只能同步部分的數據或同步失敗。
   目標庫對象名稱大小寫策略	您可以配置目標實例中同步對象的庫名和集合名的英文大小寫策略。默認情況下選擇DTS默認策略，您也可以選擇與源庫或目標庫默認策略保持一致。更多信息，請參見目標庫對象名稱大小寫策略。
   源庫對象	在源庫對象框中選擇待遷移對象，然后單擊將其移動至已選擇對象框。 說明 遷移對象的選擇粒度為DATABASE、COLLECTION。
   已選擇對象	如需更改單個遷移對象在目標實例中的名稱，請右擊已選擇對象中的遷移對象，設置方式，請參見庫表列名單個映射。 如需批量更改遷移對象在目標實例中的名稱，請單擊已選擇對象方框右上方的批量編輯，設置方式，請參見庫表列名批量映射。 說明 如果使用了對象名映射功能，可能會導致依賴這個對象的其他對象遷移失敗。 如需設置WHERE條件過濾數據，請在已選擇對象中右擊待遷移的對象，在彈出的對話框中設置過濾條件。設置方法請參見設置過濾條件。 全量遷移階段支持條件過濾數據，增量遷移階段不支持條件數據過濾。SQL條件過濾需要符合MongoDB語法規范，如下所示： {"_id":{$lte:"user100844658590795****"}}

6. 單擊下一步高級配置，進行高級配置。

   • 數據校驗配置

     若您需要使用數據校驗功能，配置方法請參見配置數據校驗。

   • 高級配置

     配置	說明
     監控報警	是否設置告警，當遷移失敗或延遲超過閾值后，將通知告警聯系人。 不設置：不設置告警。 設置：設置告警，您還需要設置告警閾值和告警聯系人。更多信息，請參見在配置任務過程中配置監控告警。
     源庫、目標庫無法連接后的重試時間	在遷移任務啟動后，若源庫或目標庫連接失敗則DTS會報錯，并會立即進行持續的重試連接，默認重試720分鐘，您也可以在取值范圍（10~1440分鐘）內自定義重試時間，建議設置30分鐘以上。如果DTS在設置的時間內重新連接上源、目標庫，遷移任務將自動恢復。否則，遷移任務將失敗。 說明 針對同源或者同目標的多個DTS實例，網絡重試時間以后創建任務的設置為準。 由于連接重試期間，DTS將收取任務運行費用，建議您根據業務需要自定義重試時間，或者在源和目標庫實例釋放后盡快釋放DTS實例。
     源庫、目標庫出現其他問題后的重試時間	在遷移任務啟動后，若源庫或目標庫出現非連接性的其他問題（如DDL或DML執行異常），則DTS會報錯并會立即進行持續的重試操作，默認持續重試時間為10分鐘，您也可以在取值范圍（1~1440分鐘）內自定義重試時間，建議設置10分鐘以上。如果DTS在設置的重試時間內相關操作執行成功，遷移任務將自動恢復。否則，遷移任務將會失敗。 重要 源庫、目標庫出現其他問題后的重試時間的值需要小于源庫、目標庫無法連接后的重試時間的值。
     是否限制全量遷移速率	在全量遷移階段，DTS將占用源庫和目標庫一定的讀寫資源，可能會導致數據庫的負載上升。您可以根據實際情況，選擇是否對全量遷移任務進行限速設置（設置每秒查詢源庫的速率QPS、每秒全量遷移的行數RPS和每秒全量遷移的數據量MB），以緩解目標庫的壓力。 說明 僅當遷移類型選擇了全量遷移時才可以配置。
     是否限制增量遷移速率	您也可以根據實際情況，選擇是否對增量遷移任務進行限速設置（設置每秒增量遷移的行數RPS和每秒增量遷移的數據量MB），以緩解目標庫的壓力。 說明 僅當遷移類型選擇了增量遷移時才可以配置。
     配置ETL功能	選擇是否配置ETL功能。關于ETL的更多信息，請參見什么是ETL。 是：配置ETL功能，并在文本框中填寫數據處理語句，詳情請參見在DTS遷移或同步任務中配置ETL。 否：不配置ETL功能。

7. 上述配置完成后，單擊頁面下方的下一步保存任務并預檢查。

   您可以將鼠標光標移動至下一步保存任務并預檢查按鈕上，然后單擊氣泡中的預覽OpenAPI參數，查看調用API接口配置該實例時的參數信息。

   說明

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

   • 如果預檢查失敗，請單擊失敗檢查項后的查看詳情，并根據提示修復后重新進行預檢查。

   • 如果預檢查產生警告：

     • 對于不可以忽略的檢查項，請單擊失敗檢查項后的查看詳情，并根據提示修復后重新進行預檢查。

     • 對于可以忽略無需修復的檢查項，您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查，跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項，可能會導致數據不一致等問題，給業務帶來風險。

8. 預檢查通過率顯示為100%時，單擊下一步購買。

9. 在購買頁面，選擇數據遷移實例的鏈路規格，詳細說明請參見下表。

   類別	參數	說明
   信息配置	資源組配置	選擇實例所屬的資源組，默認為default resource group。更多信息，請參見什么是資源管理。
   	鏈路規格	DTS為您提供了不同性能的遷移規格，遷移鏈路規格的不同會影響遷移速率，您可以根據業務場景進行選擇。更多信息，請參見數據遷移鏈路規格說明。

10. 配置完成后，閱讀并選中《數據傳輸（按量付費）服務條款》。

11. 單擊購買并啟動，并在彈出的確認對話框，單擊確定。

    您可在數據遷移界面查看具體進度。

操作步驟（舊版控制臺）

1. 購買數據遷移實例，詳情請參見購買數據遷移任務。

2. 登錄數據傳輸控制臺。

   說明

   若數據傳輸控制臺自動跳轉至數據管理DMS控制臺，您可以在右下角的中單擊，返回至舊版數據傳輸控制臺。

3. 在左側導航欄，單擊數據遷移。

4. 在遷移任務列表頁面頂部，選擇阿里云MongoDB實例所屬地域。

5. 定位至已購買的數據遷移實例，單擊配置遷移任務。

6. 配置遷移任務的源庫及目標庫信息。

   

   類別	配置	說明
   無	任務名稱	DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
   源庫信息	實例類型	選擇有公網IP的自建數據庫。
   	實例地區	當實例類型選擇為有公網IP的自建數據庫時，實例地區無需設置。
   	數據庫類型	選擇MongoDB。
   	主機名或IP地址	填入MongoDB Atlas數據庫中，PRIMARY節點的訪問地址。 您可以在MongoDB Atlas控制臺中獲取，詳細步驟請參見下圖。
   	端口	填入MongoDB Atlas數據庫的服務端口，默認為27017。
   	數據庫名稱	填入鑒權數據庫名，即數據庫賬號所屬的數據庫。
   	數據庫賬號	填入MongoDB Atlas的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
   	數據庫密碼	填入該數據庫賬號的密碼。 說明 源庫信息填寫完畢后，您可以單擊數據庫密碼后的測試連接來驗證填入的源庫信息是否正確。源庫信息填寫正確則提示測試通過，如提示測試失敗，單擊測試失敗后的診斷，根據提示調整填寫的源庫信息。
   	連接方式	選擇SSL安全連接。
   目標庫信息	實例類型	選擇MongoDB實例。
   	實例地區	選擇阿里云MongoDB實例所屬地域。
   	MongoDB實例ID	選擇阿里云MongoDB實例ID。
   	數據庫名稱	填入鑒權數據庫名，即數據庫賬號所屬的數據庫。 說明 如果使用的數據庫賬號為root，那么對應的數據庫名稱即為admin。
   	數據庫賬號	填入阿里云MongoDB實例的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
   	數據庫密碼	填入該數據庫賬號的密碼。 說明 目標庫信息填寫完畢后，您可以單擊數據庫密碼后的測試連接來驗證填入的目標庫信息是否正確。目標庫信息填寫正確則提示測試通過，如提示測試失敗，單擊測試失敗后的診斷，根據提示調整填寫的目標庫信息。

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

   如果源或目標數據庫是阿里云數據庫實例（例如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網關/智能網關）的方式接入。

8. 選擇遷移類型和遷移對象。

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

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

   說明

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

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

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

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

10. 預檢查通過后，單擊下一步。

11. 在購買配置確認頁面，選擇鏈路規格并勾選數據傳輸（按量付費）服務條款。

12. 單擊購買并啟動，遷移任務正式開始。

    • 全量數據遷移

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

    • 增量數據遷移

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

      說明

      請選擇合適的時間手動結束遷移任務，例如業務低峰期或準備將業務切換至阿里云MongoDB實例時。

      1. 觀察遷移任務的進度變更為增量遷移，并顯示為無延遲狀態時，將源庫停寫幾分鐘，此時增量遷移的狀態可能會顯示延遲的時間。

      2. 等待遷移任務的增量遷移再次進入無延遲狀態，手動結束遷移任務。

13. 將業務切換至阿里云MongoDB實例。