本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
本文介紹如何使用數據傳輸服務DTS（Data Transmission Service），依次將本地MongoDB分片集群數據庫中的各個Shard節點，遷移至阿里云MongoDB分片集群實例來實現遷移上云。通過DTS的增量遷移功能，可以實現在本地應用不停服的情況下，平滑完成數據庫的遷移上云。
更多數據遷移和同步場景的解決方案，請參見MongoDB數據遷移和同步方案概覽。
前提條件
自建MongoDB和云數據庫MongoDB支持的版本，請參見遷移方案概覽。
確保目標分片集群實例中的Shard節點具備充足的存儲空間。
說明例如自建數據庫中有三個Shard節點，其中第二個Shard節點占用的存儲空間最多（500GB），那么分片集群實例中的每個Shard節點的存儲空間均需要大于500GB。
遷移原理介紹
DTS通過遷移分片集群中的每個Shard節點來實現分片集群數據庫的整體遷移，您需要為每個Shard節點創建一個對應的數據遷移任務。
數據在目標MongoDB實例中的分布取決于您設置的片鍵，詳情請參見設置數據分片以充分利用Shard性能。
注意事項
DTS在執行全量數據遷移時將占用源庫和目標庫一定的資源，可能會導致數據庫服務器負載上升。如果數據庫業務量較大或服務器規格較低，可能會加重數據庫壓力，甚至導致數據庫服務不可用。建議您在執行數據遷移前謹慎評估，在業務低峰期執行數據遷移。
MongoDB實例支持的版本與存儲引擎請參見版本及存儲引擎，如需跨版本或跨引擎遷移，請提前確認兼容性。
由于DTS寫入數據的邏輯為并發寫入，所以會導致目標端占用的存儲空間比源端大5%~10%。
請確保目標端MongoDB沒有與源端相同的主鍵（默認為_id），否則會導致數據丟失。若目標端有與源端相同的主鍵，請在不影響業務的前提條件下清空目標端的相關數據（刪掉目標端中與源端相同_id的文檔）。
不支持數據庫admin和local作為源和目標庫。
源MongoDB分片集群實例的Mongos節點的數量不能超過10個。
費用說明
遷移類型 | 鏈路配置費用 | 公網流量費用 |
全量數據遷移 | 不收費。 | 通過公網將數據遷移出阿里云時將收費，詳情請參見DTS產品定價。 |
增量數據遷移 | 收費，詳情請參見DTS產品定價。 |
遷移類型說明
全量數據遷移：將源MongoDB數據庫遷移對象的存量數據全部遷移到目標MongoDB數據庫中。
說明支持database、collection、index的遷移。
增量數據遷移：在全量遷移的基礎上，將源MongoDB數據庫的增量更新數據同步到目標MongoDB數據庫中。
說明支持database、collection、index的新建和刪除操作的同步。
支持document的新增、刪除和更新操作的同步。
數據庫賬號的權限要求
數據庫 | 全量數據遷移 | 增量數據遷移 |
自建MongoDB數據庫 | 待遷移庫的read權限 | 待遷移庫、admin庫和local庫的read權限 |
阿里云MongoDB數據庫 | 目標庫的readWrite權限 | 目標庫的readWrite權限 |
數據庫賬號創建及授權方法：
自建MongoDB數據庫請參見MongoDB Create User說明。
阿里云MongoDB實例請參見使用DMS管理MongoDB數據庫用戶。
準備工作
必需：為避免塊遷移對數據一致性的影響，遷移期間需要關閉自建MongoDB數據庫的均衡器（Balancer），詳情請參見管理MongoDB均衡器Balancer 。
警告如果未關閉均衡器，遷移期間發生了塊遷移將影響DTS讀取到的數據的一致性。
清除自建MongoDB數據庫中，因塊遷移失敗而產生的孤立文檔。
說明如果未清除孤立文檔，將影響遷移性能，而且可能在遷移過程會遇到
_id沖突的文檔，導致遷移錯誤的數據。下載cleanupOrphaned.js腳本文件。
wget "https://docs-aliyun.cn-hangzhou.oss.aliyun-inc.com/assets/attach/120562/cn_zh/1564451237979/cleanupOrphaned.js"修改cleanupOrphaned.js腳本文件，將
test替換為待清理孤立文檔的數據庫名。說明如果您有多個數據庫，您需要重復執行本步驟和步驟c。
執行如下命令，清理Shard節點中指定數據庫下所有集合的孤立文檔。
說明您需要重復執行本步驟，為每個Shard節點清理孤立文檔。
mongo --host <Shardhost> --port <Primaryport> --authenticationDatabase <database> -u <username> -p <password> cleanupOrphaned.js說明<Shardhost>：Shard節點的IP地址。
<Primaryport>：Shard節點中的Primary節點的服務端口。
<database>：鑒權數據庫名，即數據庫賬號所屬的數據庫。
<username>：登錄數據庫的賬號。
<password>：登錄數據庫的密碼。
示例：
本案例的自建MongoDB數據庫有三個Shard節點，所以需要分別為這三個節點清除孤立文檔。
mongo --host 172.16.1.10 --port 27018 --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.jsmongo --host 172.16.1.11 --port 27021 --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.jsmongo --host 172.16.1.12 --port 27024 --authenticationDatabase admin -u dtstest -p 'Test123456' cleanupOrphaned.js
根據業務需要，在目標MongoDB實例中創建需要分片的數據庫和集合，并配置數據分片，詳情請參見設置數據分片以充分利用Shard性能。
說明在配置數據遷移前配置數據分片，可避免數據被遷移至同一Shard中，導致單個Shard使用的存儲空間超出預期規劃。
操作步驟
登錄數據傳輸控制臺。
在左側導航欄，單擊數據遷移。
在遷移任務列表頁面頂部，選擇目標MongoDB實例所屬地域。
單擊右上角的創建遷移任務。
配置遷移任務的源庫及目標庫信息。
類別
配置
說明
無
任務名稱
DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
源庫信息
實例類型
根據源庫的部署位置進行選擇，本文以有公網IP的自建數據庫為例介紹配置流程。
說明當自建數據庫為其他實例類型時，您還需要執行相應的準備工作，詳情請參見準備工作概覽。
實例地區
當實例類型選擇為有公網IP的自建數據庫時，實例地區無需設置。
說明如果您的自建數據庫具備白名單安全類設置，您需要在實例地區配置項后，單擊獲取DTS IP段來獲取DTS服務器的IP地址，并將獲取到的IP地址加入自建數據庫的白名單安全設置中。
數據庫類型
選擇MongoDB。
主機名或IP地址
填入自建MongoDB數據庫中，單個Shard節點的域名或IP地址，本案例填入公網IP地址。
說明DTS通過依次遷移分片集群中的每個Shard節點來實現整體遷移，此處先填入第一個Shard節點的域名或IP地址，稍后創建第二個遷移任務時，此處填入第二個Shard節點的域名或IP地址。以此類推，直至遷移所有Shard節點。
端口
填入對應Shard節點的服務端口。
說明本案例中，各Shard節點的服務端口須開放至公網。
數據庫名稱
填入鑒權數據庫名，即數據庫賬號所屬的數據庫。
數據庫賬號
填入自建MongoDB數據庫的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
說明源庫信息填寫完畢后，您可以單擊數據庫密碼后的測試連接來驗證填入的源庫信息是否正確。源庫信息填寫正確則提示測試通過，如提示測試失敗，單擊測試失敗后的診斷，根據提示調整填寫的源庫信息。
連接方式
選擇非加密連接。
說明只有在遷移MongoDB Atlas數據庫時，才能選擇SSL安全連接。
目標庫信息
實例類型
選擇MongoDB實例。
實例地區
選擇目標MongoDB實例所在地域。
MongoDB實例ID
選擇目標分片集群實例ID。
數據庫名稱
填入鑒權數據庫名，即數據庫賬號所屬的數據庫。
數據庫賬號
填入MongoDB實例的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
說明目標庫信息填寫完畢后，您可以單擊數據庫密碼后的測試連接來驗證填入的目標庫信息是否正確。目標庫信息填寫正確則提示測試通過，如提示測試失敗，單擊測試失敗后的診斷，根據提示調整填寫的目標庫信息。
配置完成后，單擊頁面右下角的授權白名單并進入下一步。
如果源或目標數據庫是阿里云數據庫實例（例如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網關/智能網關）的方式接入。
選擇遷移對象和遷移類型。
配置 說明 遷移類型 - 如果只需要進行全量遷移，則勾選全量數據遷移。
- 如果需要進行不停機遷移，則同時勾選全量數據遷移和增量數據遷移。
說明 如果未勾選增量數據遷移，為保障數據一致性，數據遷移期間請勿在自建MongoDB數據庫中寫入新的數據。遷移對象 - 在遷移對象框中單擊待遷移的對象，然后單擊
圖標將其移動到已選擇對象框。 說明 不支持遷移admin、local、config數據庫。 - 遷移對象選擇的粒度為database、collection或function。
- 默認情況下，遷移完成后，遷移對象的名稱保持不變。如果您需要改變遷移對象在目標數據庫中的名稱，那么需要使用DTS提供的對象名映射功能。使用方法請參見庫表列映射。
映射名稱更改 如需更改遷移對象在目標實例中的名稱，請使用對象名映射功能，詳情請參見庫表列映射。 源、目標庫無法連接重試時間 默認重試12小時，您也可以自定義重試時間。如果DTS在設置的時間內重新連接上源、目標庫，遷移任務將自動恢復。否則，遷移任務將失敗。 說明 由于連接重試期間，DTS將收取任務運行費用，建議您根據業務需要自定義重試時間，或者在源和目標庫實例釋放后盡快釋放DTS實例。上述配置完成后，單擊頁面右下角的預檢查并啟動。
說明在遷移任務正式啟動之前，會先進行預檢查。只有預檢查通過后，才能成功啟動遷移任務。
如果預檢查失敗，單擊具體檢查項后的
，查看失敗詳情。您可以根據提示修復后重新進行預檢查。
如無需修復告警檢測項，您也可以選擇確認屏蔽、忽略告警項并重新進行預檢查，跳過告警檢測項重新進行預檢查。
預檢查通過后，單擊下一步。
在購買配置確認頁面，選擇鏈路規格并選中數據傳輸（按量付費）服務條款。
單擊購買并啟動，遷移任務正式開始。
重復第1步到第11步的操作，為剩余的Shard節點創建遷移任務。
完成遷移任務。
全量數據遷移
請勿手動結束遷移任務，否則可能會導致數據不完整。您只需等待遷移任務完成即可，遷移任務會自動結束。
增量數據遷移
遷移任務不會自動結束，需要手動結束遷移任務。
說明請選擇合適的時間手動結束遷移任務，例如業務低峰期或準備將業務切換至MongoDB實例時。
等待所有Shard節點的遷移任務的進度變更為增量遷移，并顯示為無延遲狀態時，將源庫停寫幾分鐘，此時增量遷移的狀態可能會顯示延遲的時間。
等待所有Shard節點遷移任務的增量遷移再次進入無延遲狀態后，手動結束遷移任務。
將業務切換至阿里云MongoDB實例。