本文介紹如何使用Data Transmission Service，依次將本地MongoDB分區叢集資料庫中的各個Shard節點，遷移至阿里雲MongoDB分區叢集執行個體來實現遷移上雲。通過DTS的增量遷移功能，可以實現在本地應用不停服的情況下，平滑完成資料庫的遷移上雲。
更多資料移轉和同步情境的解決方案，請參見MongoDB資料移轉和同步方案概覽。
前提條件
自建MongoDB和ApsaraDB for 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使用的儲存空間超出預期規劃。
操作步驟
進入目標地區的遷移工作清單頁面（二選一）。
通過DTS控制台進入
在左側導覽列，單擊資料移轉。
在頁面左上方，選擇遷移執行個體所屬地區。
通過DMS控制台進入
說明實際操作可能會因DMS的模式和布局不同，而有所差異。更多資訊。請參見極簡模式控制台和自訂DMS介面布局與樣式。
在頂部功能表列中，選擇。
在遷移任務右側，選擇遷移執行個體所屬地區。
單擊創建任務，進入任務配置頁面。
配置源庫及目標庫資訊。
警告選擇源和目標執行個體後，建議您仔細閱讀頁面上方顯示的使用限制，否則可能會導致任務失敗或資料不一致。
類別
配置
說明
無
任務名稱
DTS會自動產生一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便於後續識別。
源庫資訊
選擇已有串連資訊
若您需要使用已錄入系統（建立或儲存）的資料庫執行個體，請在下拉式清單中選擇所需的資料庫執行個體，下方的資料庫資訊將自動進行配置。
說明DMS控制台的配置項為選擇DMS資料庫執行個體。
若您未將資料庫執行個體錄入到系統，或無需使用已錄入系統的資料庫執行個體，則需要手動設定下方的資料庫資訊。
資料庫類型
選擇MongoDB。
接入方式
請根據源庫的部署位置進行選擇，本樣本以公網IP為例介紹配置流程。
說明當選擇其他方式接入自建資料庫時，您還需要執行相應的準備工作。
執行個體地區
選擇自建MongoDB資料庫所屬地區。
說明若選項中沒有自建MongoDB資料庫所屬的地區，您可以選擇一個距離該資料庫最近的地區。
架構類型
選擇分區叢集架構。
說明僅當以專線/VPN網關/智能網關、公網IP或Cloud Enterprise NetworkCEN的方式接入自建MongoDB時，才會出現分區叢集架構選項。
遷移方式
請根據實際情況，選擇增量資料移轉的方式。
Oplog（推薦）：
若源庫已開啟Oplog日誌，則支援此選項。
說明本地自建MongoDB和ApsaraDB for MongoDB預設已開啟Oplog日誌，且使用此方式遷移增量資料時增量遷移任務的延遲較小（拉取日誌的速度較快），因此推薦選擇Oplog。
ChangeStream：若源庫已開啟變更流（Change Streams），則支援此選項。
說明源庫為Amazon DocumentDB（非彈性叢集）時，僅支援選擇ChangeStream。
源庫架構類型選擇為分區叢集架構，無需填寫Shard賬號和Shard密碼。
串連地址類型
請根據實際情況選擇單節點或多節點。
說明僅當以專線/VPN網關/智能網關、公網IP或Cloud Enterprise NetworkCEN的方式接入自建MongoDB時，才會出現此配置項。
Mongos網域名稱或IP地址
填入自建MongoDB資料庫中，單個Mongos節點的網域名稱或IP地址，本案例填入公網IP地址。
說明僅當串連地址類型為單節點時，才會出現此配置項。
Mongos網域名稱或IP地址和連接埠填入任一組Mongos節點的IP地址（或網域名稱）和連接埠。
連接埠
填入自建MongoDB資料庫的服務連接埠。
說明僅當串連地址類型為單節點時，才會出現此配置項。
各Mongos節點的服務連接埠須開放至公網。
Mongos串連地址
填入自建MongoDB資料庫的串連地址。
說明僅當串連地址類型為多節點時，才會出現此配置項。
格式為
<IP>:<Port>。其中<IP>為網域名稱或者IP地址，建議使用公網可解析的網域名稱。多個串連地址可以使用斷行符號鍵換行進行分隔。
鑒權資料庫名稱
填入自建MongoDB中資料庫帳號所屬的資料庫名稱，若未修改過則預設為admin。
資料庫帳號
填入自建MongoDB對應Mongos節點的帳號。許可權要求，請參見資料庫帳號的許可權要求。
說明若自建MongoDB的接入方式為ECS自建資料庫或資料庫網關DG，則填入Shard節點的帳號。
資料庫密碼
填入該資料庫帳號對應的密碼。
多Shard節點接入資訊
配置自建MongoDB資料庫的Shard節點接入資訊。
說明當自建MongoDB資料庫為源庫、架構類型選擇為分區叢集架構、遷移方式選擇為Oplog，且串連地址類型選擇為多節點時，才會出現此配置項。
單擊多Shard節點接入資訊右側的添加按鈕。
在Shard串連地址文字框中，填入自建MongoDB資料庫某個Shard節點的串連地址。
說明當架構類型選擇為複本集架構時，需配置的參數為串連地址；當架構類型選擇為分區叢集架構，需配置的參數為Mongos串連地址。
格式為
<IP>:<Port>。其中<IP>為網域名稱或者IP地址，建議使用公網可解析的網域名稱。多個串連地址可以使用斷行符號鍵換行進行分隔。
重複上述操作，配置每個Shard節點接入資訊。
Shard接入信息(IP:Port)
填入自建MongoDB資料庫Shard節點的IP地址和連接埠資訊，格式為
<IP>:<Port>。說明僅當串連地址類型為單節點時，才會出現此配置項。
多個Shard節點資訊可以使用逗號（,）進行分隔。
Shard賬號
填入自建MongoDB資料庫的Shard帳號。
Shard密碼
填入自建MongoDB資料庫Shard帳號的密碼。
串連方式
DTS支援非加密串連、SSL安全連線和Mongo Atlas SSL三種串連方式。串連方式的選項與接入方式和架構類型有關，請以控制台為準。
說明架構類型為分區叢集架構，且遷移方式為Oplog的MongoDB資料庫，不支援SSL安全連線。
若源庫為自建（接入方式不為雲執行個體）複本集架構的MongoDB資料庫，並且選擇了SSL安全連線，DTS還支援上傳CA認證對串連進行校正。
目標庫資訊
選擇已有串連資訊
若您需要使用已錄入系統（建立或儲存）的資料庫執行個體，請在下拉式清單中選擇所需的資料庫執行個體，下方的資料庫資訊將自動進行配置。
說明DMS控制台的配置項為選擇DMS資料庫執行個體。
若您未將資料庫執行個體錄入到系統，或無需使用已錄入系統的資料庫執行個體，則需要手動設定下方的資料庫資訊。
資料庫類型
選擇MongoDB。
接入方式
選擇雲執行個體。
執行個體地區
選擇目標ApsaraDB for MongoDB執行個體所屬地區。
是否跨阿里雲帳號
本樣本使用當前阿里雲帳號下的資料庫執行個體，需選擇不跨帳號。
架構類型
選擇目標ApsaraDB for MongoDB所屬的架構類型。
執行個體ID
選擇目標ApsaraDB for MongoDB執行個體的ID。
鑒權資料庫名稱
填入目標ApsaraDB for MongoDB執行個體資料庫帳號所屬的資料庫名稱，若未修改過則預設為admin。
資料庫名稱
填入目標ApsaraDB for MongoDB執行個體中遷移對象所屬資料庫的名稱。
資料庫帳號
填入目標ApsaraDB for MongoDB執行個體的資料庫帳號。許可權要求，請參見資料庫帳號的許可權要求。
資料庫密碼
填入該資料庫帳號對應的密碼。
串連方式
DTS支援非加密串連、SSL安全連線和Mongo Atlas SSL三種串連方式。串連方式的選項與接入方式和架構類型有關，請以控制台為準。
說明架構類型為分區叢集架構的MongoDB資料庫，不支援SSL安全連線。
若目標庫為自建（接入方式不為雲執行個體）複本集架構的MongoDB資料庫，並且選擇了SSL安全連線，DTS還支援上傳CA認證對串連進行校正。
配置完成後，在頁面下方單擊測試連接以進行下一步，並在彈出的DTS伺服器訪問授權對話方塊單擊測試連接。
說明請確保DTS服務的IP位址區段能夠被自動或手動添加至源庫和目標庫的安全設定中，以允許DTS伺服器的訪問。更多資訊，請參見添加DTS伺服器的IP位址區段。
配置任務對象。
在對象配置頁面，配置待遷移的對象。
配置
說明
遷移類型
如果只需要進行全量遷移，建議同時選中庫表結構遷移和全量遷移。
如果需要進行不停機遷移，建議同時選中庫表結構遷移、全量遷移和增量遷移。
說明若未選中庫表結構遷移，請確保目標庫中存在接收資料的資料庫和表，並根據實際情況，在已選擇對象框中使用庫表列名映射功能。
若未選中增量遷移，為保障資料一致性，資料移轉期間請勿在源執行個體中寫入新的資料。
目標已存在表的處理模式
預檢查並報錯攔截：檢查目標資料庫中是否有同名的表。如果目標資料庫中沒有同名的表，則通過該檢查專案；如果目標資料庫中有同名的表，則在預檢查階段提示錯誤，資料移轉任務不會被啟動。
說明如果目標庫中同名的表不方便刪除或重新命名，您可以更改該表在目標庫中的名稱，請參見庫表列名映射。
忽略報錯並繼續執行：跳過目標資料庫中是否有同名表的檢查項。
警告選擇為忽略報錯並繼續執行，可能導致資料不一致，給業務帶來風險，例如：
表結構一致的情況下，在目標庫遇到與源庫主鍵的值相同的記錄：
全量期間，DTS會保留目的地組群中的該條記錄，即源庫中的該條記錄不會遷移至目標資料庫中。
增量期間，DTS不會保留目的地組群中的該條記錄，即源庫中的該條記錄會覆蓋至目標資料庫中。
表結構不一致的情況下，可能導致只能遷移部分列的資料或遷移失敗，請謹慎操作。
目標庫對象名稱大小寫策略
您可以配置目標執行個體中遷移對象的庫名、集合名的英文大小寫策略。預設情況下選擇DTS預設策略，您也可以選擇與源庫、目標庫預設策略保持一致。更多資訊，請參見目標庫對象名稱大小寫策略。
源庫對象
在源庫對象框中單擊待遷移的對象，然後單擊
將其移動到已選擇對象框。說明遷移對象選擇的粒度為Collection或Database。
已選擇對象
如需設定待遷移對象在目標執行個體中的名稱，或指定目標執行個體中接收資料的對象，請右擊已選擇對象中的遷移對象進行修改。設定方式，請參見庫表列名映射。
如需移除已選擇的遷移對象，請在已選擇對象框中單擊待遷移的對象，然後單擊
將其移動到源庫對象框。
說明如需按庫或集合層級選擇增量遷移的操作，請在已選擇對象中右擊待遷移的對象，並在彈出的對話方塊中進行選擇。
如需設定條件過濾資料（全量遷移階段支援條件過濾資料，增量遷移階段不支援），請在已選擇對象中右擊待遷移的表，並在彈出的對話方塊中進行設定。設定方法，請參見設定過濾條件。
如果使用了對象名映射功能（指定用於接收資料的資料庫或集合），可能會導致依賴這個對象的其他對象遷移失敗。
單擊下一步高級配置，進行進階參數配置。
配置
說明
選擇調度該任務的專屬叢集
DTS預設將任務調度到共用叢集上，您無需選擇。您可以購買指定規格的專屬叢集來運行DTS遷移任務，詳情請參見什麼是DTS專屬叢集。
源庫、目標庫無法串連後的重試時間
在遷移任務啟動後，若源庫或目標庫串連失敗則DTS會報錯，並會立即進行持續的重試串連，預設重試720分鐘，您也可以在取值範圍（10~1440分鐘）內自訂重試時間，建議設定30分鐘以上。如果DTS在設定的時間內重新串連上源、目標庫，遷移任務將自動回復。否則，遷移任務將失敗。
說明針對同源或者同目標的多個DTS執行個體，網路重試時間以後建立任務的設定為準。
由於串連重試期間，DTS將收取任務運行費用，建議您根據業務需要自訂重試時間，或者在源和目標庫執行個體釋放後儘快釋放DTS執行個體。
源庫、目標庫出現其他問題後的重試時間
在遷移任務啟動後，若源庫或目標庫出現非串連性的其他問題（如DDL或DML執行異常），則DTS會報錯並會立即進行持續的重試操作，預設持續重試時間為10分鐘，您也可以在取值範圍（1~1440分鐘）內自訂重試時間，建議設定10分鐘以上。如果DTS在設定的重試時間內相關操作執行成功，遷移任務將自動回復。否則，遷移任務將會失敗。
重要源庫、目標庫出現其他問題後的重試時間的值需要小於源庫、目標庫無法串連後的重試時間的值。
是否限制全量遷移速率
在全量遷移階段，DTS將佔用源庫和目標庫一定的讀寫資源，可能會導致資料庫的負載上升。您可以根據實際情況，選擇是否對全量遷移任務進行限速設定（設定每秒查詢源庫的速率QPS、每秒全量遷移的行數RPS和每秒全量遷移的數據量(MB)BPS），以緩解目標庫的壓力。
說明僅當遷移類型選擇了全量遷移，才有此配置項。
您也可以在遷移執行個體運行後，調整全量遷移的速率。
待同步的數據中，同一張表內主鍵_id的資料類型是否唯一
待遷移的資料中，同一個集合內主鍵
_id的資料類型是否唯一。重要請根據實際情況選擇，否則可能會導致資料丟失。
僅當遷移類型選擇了全量遷移，才有此配置項。
是：唯一。在全量遷移階段，DTS將不會掃描源庫待遷移資料中主鍵的資料類型；在單個集合中，DTS僅會遷移一種資料類型的主鍵所對應的資料。
否：不唯一。在全量遷移階段，DTS將掃描源庫待遷移資料中主鍵的資料類型，並遷移其所有資料。
是否限制增量遷移速率
您也可以根據實際情況，選擇是否對增量遷移任務進行限速設定（設定每秒增量遷移的行數RPS和每秒增量遷移的數據量(MB)BPS），以緩解目標庫的壓力。
說明僅當遷移類型選擇了增量遷移，才有此配置項。
您也可以在遷移執行個體運行後，調整增量遷移的速率。
環境標籤
您可以根據實際情況，選擇用於標識執行個體的環境標籤。本樣本無需選擇。
配置ETL功能
選擇是否配置ETL功能。關於ETL的更多資訊，請參見什麼是ETL。
是：配置ETL功能，並在文字框中填寫資料處理語句，詳情請參見在DTS遷移或同步任務中配置ETL。
否：不配置ETL功能。
監控警示
根據業務需求選擇是否設定警示並接收警示通知。
不設定：不設定警示。
設定：設定警示。您還需要設定警示閾值和警示通知，當遷移失敗或延遲超過閾值後，系統將進行警示通知。
單擊下一步資料校正，進行資料校正任務配置。
若您需要使用資料校正功能，配置方法請參見配置資料校正。
儲存任務並進行預檢查。
若您需要查看調用API介面配置該執行個體時的參數資訊，請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上，然後單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數，請單擊頁面下方的下一步儲存任務並預檢查。
說明在遷移任務正式啟動之前，會先進行預檢查。只有預檢查通過後，才能成功啟動遷移任務。
如果預檢查失敗，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。
如果預檢查產生警告：
對於不可以忽略的檢查項，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。
對於可以忽略無需修複的檢查項，您可以依次單擊點擊確認警示詳情、確認屏蔽、確定、重新進行預檢查，跳過警示檢查項重新進行預檢查。如果選擇屏蔽警示檢查項，可能會導致資料不一致等問題，給業務帶來風險。
購買執行個體。
預檢查通過率顯示為100%時，單擊下一步購買。
在購買頁面，選擇資料移轉執行個體的鏈路規格，詳細說明請參見下表。
類別
參數
說明
資訊配置
資源群組配置
選擇執行個體所屬的資源群組，預設為default resource group。更多資訊，請參見什麼是資源管理。
鏈路規格
DTS為您提供了不同效能的遷移規格，遷移鏈路規格的不同會影響遷移速率，您可以根據業務情境進行選擇。更多資訊，請參見資料移轉鏈路規格說明。
配置完成後，閱讀並選中《資料轉送（隨用隨付）服務條款》。
單擊購買並啟動，並在彈出的確認對話方塊，單擊確定。
您可以在遷移任務列表頁面，查看遷移執行個體的具體進度。
說明若遷移執行個體不包含增量遷移任務，則遷移執行個體會自動結束。遷移執行個體自動結束後，運行狀態為已完成。
若遷移執行個體包含增量遷移任務，則遷移執行個體不會自動結束，增量遷移任務會持續進行。在增量遷移任務正常運行期間，遷移執行個體的運行狀態為運行中。
（可選）：若自建MongoDB的接入方式為ECS自建資料庫或資料庫網關DG，您還需參考步驟1~步驟7，為剩餘的Shard節點建立遷移任務。
完成遷移任務。
全量資料移轉
請勿手動結束遷移任務，否則可能會導致資料不完整。您只需等待遷移任務完成即可，遷移任務會自動結束。
增量資料移轉
遷移任務不會自動結束，需要手動結束遷移任務。
說明請選擇合適的時間手動結束遷移任務，例如業務低峰期或準備將業務切換至MongoDB執行個體時。
等待所有Shard節點的遷移任務的運行階段進入增量遷移，且運行資訊中顯示無延遲狀態時，將源庫停寫幾分鐘，此時的狀態可能會顯示延遲的時間。
等待所有Shard節點遷移任務的增量遷移再次進入無延遲狀態後，手動結束遷移任務。