本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業務造成影響,請務必仔細閱讀。
本文介紹如何使用數據傳輸服務DTS(Data Transmission Service),將MongoDB數據庫(單節點架構)全量遷移至MongoDB數據庫(所有架構)。
支持的源和目標數據庫
源和目標數據庫的接入方式需保持一致,例如源庫和目標庫的接入方式均選擇為云實例。
源數據庫(單節點架構) | 目標數據庫(所有架構) |
云數據庫MongoDB版 | 云數據庫MongoDB版 |
ECS上的自建數據庫 | ECS上的自建數據庫 |
通過專線、VPN網關或智能網關接入的自建數據庫 | 通過專線、VPN網關或智能網關接入的自建數據庫 |
有公網IP的自建數據庫 | 有公網IP的自建數據庫 |
本文以云數據庫MongoDB版(單節點架構)、云數據庫MongoDB版(所有架構)為例介紹配置流程,其他數據源的配置流程與本案例相似。
前提條件
已創建源云數據庫MongoDB版(單節點架構)和目標云數據庫MongoDB版(所有架構)。創建方式,請參見創建單節點實例、創建副本集實例和創建分片集群實例。
說明支持的版本,請參見遷移方案概覽。
建議目標云數據庫MongoDB版的存儲空間比源云數據庫MongoDB版占用的存儲空間大10%。
如目標云數據庫MongoDB版為分片集群架構,您需要根據業務需要,在目標云數據庫MongoDB版中創建需要分片的數據庫和集合、配置數據分片、開啟Balancer并進行預分片。更多信息,請參見設置數據分片以充分利用Shard性能和如何處理分片集群架構的MongoDB數據分布不均衡。
說明配置數據分片可避免數據被遷移至同一Shard,導致無法發揮集群性能;開啟Balancer并進行預分片可以避免數據傾斜問題。
注意事項
類型 | 說明 |
源庫限制 |
|
其他限制 |
|
特殊情況 | 當源庫為自建MongoDB時,在遷移時,如果源庫進行主備切換,將會導致遷移任務失敗。 |
費用說明
遷移類型 | 鏈路配置費用 | 公網流量費用 |
結構遷移和全量數據遷移 | 不收費。 | 通過公網將數據遷移出阿里云時將收費,詳情請參見計費概述。 |
遷移類型說明
遷移類型 | 說明 |
結構遷移 | 將源云數據庫MongoDB版中遷移對象的結構遷移到目標云數據庫MongoDB版中。 說明 支持結構遷移的對象為DATABASE、COLLECTION、INDEX。 |
全量遷移 | 將源云數據庫MongoDB版遷移對象的存量數據全部遷移到目標云數據庫MongoDB版中。 說明 支持全量遷移DATABASE和COLLECTION中的數據。 |
數據庫賬號的權限要求
數據庫 | 庫表結構遷移 | 全量遷移 |
源云數據庫MongoDB版 | 待遷移庫和config庫的read權限。 | |
目標云數據庫MongoDB版 | dbAdminAnyDatabase權限、目標庫的readWrite權限、local庫的read權限。 |
源和目標云數據庫MongoDB版數據庫賬號創建及授權方法,請參見使用DMS管理MongoDB數據庫用戶。
操作步驟
進入目標地域的遷移任務列表頁面(二選一)。
通過DTS控制臺進入
登錄數據傳輸服務DTS控制臺。
在左側導航欄,單擊數據遷移。
在頁面左上角,選擇遷移實例所屬地域。
通過DMS控制臺進入
說明實際操作可能會因DMS的模式和布局不同,而有所差異。更多信息。請參見極簡模式控制臺和自定義DMS界面布局與樣式。
登錄DMS數據管理服務。
在頂部菜單欄中,選擇
。在遷移任務右側,選擇遷移實例所屬地域。
單擊創建任務,進入任務配置頁面。
可選:在頁面右上角,單擊試用新版配置頁。
說明若您已進入新版配置頁(頁面右上角的按鈕為返回舊版配置頁),則無需執行此操作。
新版配置頁和舊版配置頁部分參數有差異,建議使用新版配置頁。
配置源庫及目標庫信息。
警告選擇源和目標實例后,建議您仔細閱讀頁面上方顯示的使用限制,否則可能會導致任務失敗或數據不一致。
類別
配置
說明
無
任務名稱
DTS會自動生成一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便于后續識別。
源庫信息
選擇DMS數據庫實例
您可以按實際需求,選擇是否使用已有實例。
如使用已有實例,下方數據庫信息將自動填入,您無需重復輸入。
如不使用已有實例,您需要輸入下方的數據庫信息。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇源云數據庫MongoDB版所屬地域。
是否跨阿里云賬號
本示例為同一阿里云賬號間的遷移,選擇不跨賬號。
架構類型
單節點架構的MongoDB需選擇副本集架構。
遷移方式
源庫為單節點架構的MongoDB時不支持增量遷移,保持默認的Oplog即可。
實例ID
選擇源云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入源云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱,若未修改過則默認為admin。
數據庫賬號
填入源云數據庫MongoDB版的數據庫賬號,權限要求,請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
連接方式
DTS支持非加密連接、SSL安全連接和Mongo Atlas SSL三種連接方式。連接方式的選項與接入方式和架構類型有關,請以控制臺為準。
說明接入方式為云實例時,僅副本集架構的MongoDB數據庫支持此配置項。
若源庫為自建(接入方式不為云實例)副本集架構的MongoDB數據庫,并且選擇了SSL安全連接,DTS還支持上傳CA證書對連接進行校驗。
目標庫信息
選擇DMS數據庫實例
您可以按實際需求,選擇是否使用已有實例。
如使用已有實例,下方數據庫信息將自動填入,您無需重復輸入。
如不使用已有實例,您需要輸入下方的數據庫信息。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇目標云數據庫MongoDB版所屬地域。
架構類型
根據您的業務需求選擇架構,取值:
實例ID
選擇目標云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入目標云數據庫MongoDB版數據庫賬號所屬的數據庫名稱,若未修改過則默認為admin。
數據庫賬號
填入目標云數據庫MongoDB版的數據庫賬號,權限要求,請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
連接方式
DTS支持非加密連接、SSL安全連接和Mongo Atlas SSL三種連接方式。連接方式的選項與接入方式和架構類型有關,請以控制臺為準。
說明接入方式為云實例時,僅副本集架構的MongoDB數據庫支持此配置項。
若目標庫為自建(接入方式不為云實例)副本集架構的MongoDB數據庫,并且選擇了SSL安全連接,DTS還支持上傳CA證書對連接進行校驗。
配置完成后,單擊頁面下方的測試連接以進行下一步。
如果源或目標數據庫是阿里云數據庫實例(例如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網關/智能網關)的方式接入。
配置任務對象及高級配置。
配置
說明
遷移類型
同時選中庫表結構遷移和全量遷移。
說明本場景暫不支持增量遷移,為保障數據一致性,數據遷移期間請勿在源實例中寫入新的數據。
更多任務步驟信息,請參見遷移類型說明。
目標已存在表的處理模式
- 預檢查并報錯攔截:檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合,則通過該檢查項目;如果目標數據庫中有同名的集合,則在預檢查階段提示錯誤,數據遷移任務不會被啟動。 說明 如果目標庫中同名的集合不方便刪除或重命名,您可以更改該集合在目標庫中的名稱,請參見庫表列名映射。
- 忽略報錯并繼續執行:跳過目標數據庫中是否有同名集合的檢查項。 警告 選擇為忽略報錯并繼續執行,可能導致數據不一致,給業務帶來風險,例如:
- 在目標庫遇到與源庫主鍵的值相同的記錄,則會保留目標庫中的該條記錄,即源庫中的該條記錄不會遷移至目標庫中。
- 可能會導致無法初始化數據、只能遷移部分的數據或遷移失敗。
目標庫對象名稱大小寫策略
您可以配置目標實例中遷移對象的庫名、集合名的英文大小寫策略。默認情況下選擇DTS默認策略,您也可以選擇與源庫、目標庫默認策略保持一致。更多信息,請參見目標庫對象名稱大小寫策略。
源庫對象
在源庫對象框中單擊待遷移的對象,然后單擊將其移動到已選擇對象框。
說明遷移對象的選擇粒度為DATABASE、COLLECTION。
已選擇對象
如需更改單個遷移對象在目標實例中的名稱,請右擊已選擇對象中的遷移對象,設置方式,請參見庫表列名單個映射。
如需批量更改遷移對象在目標實例中的名稱,請單擊已選擇對象方框右上方的批量編輯,設置方式,請參見庫表列名批量映射。
說明如果使用了對象名映射功能,可能會導致依賴這個對象的其他對象遷移失敗。
如需設置WHERE條件過濾數據,請在已選擇對象中右擊待遷移的表,在彈出的對話框中設置過濾條件。設置方法請參見設置過濾條件。
僅當源庫為MongoDB時,全量遷移階段支持條件過濾數據,增量遷移階段不支持條件數據過濾。SQL條件過濾需要符合MongoDB語法規范,如下所示:
{"_id":{$lte:"user100844658590795****"}}
- 預檢查并報錯攔截:檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合,則通過該檢查項目;如果目標數據庫中有同名的集合,則在預檢查階段提示錯誤,數據遷移任務不會被啟動。
單擊下一步高級配置,進行高級配置。
數據校驗配置
若您需要配置數據校驗,請參見配置數據校驗。
高級配置
配置
說明
選擇調度該任務的專屬集群
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),以緩解目標庫的壓力。
說明僅當遷移類型選擇了全量遷移時才可以配置。
是否限制增量遷移速率
您也可以根據實際情況,選擇是否對增量遷移任務進行限速設置(設置每秒增量遷移的行數RPS和每秒增量遷移的數據量(MB)BPS),以緩解目標庫的壓力。
說明僅當遷移類型選擇了增量遷移時才可以配置。
環境標簽
您可以根據實際情況,選擇用于標識實例的環境標簽。本示例無需選擇。
配置ETL功能
選擇是否配置ETL功能。關于ETL的更多信息,請參見什么是ETL。
是:配置ETL功能,并在文本框中填寫數據處理語句,詳情請參見在DTS遷移或同步任務中配置ETL。
否:不配置ETL功能。
保存任務并進行預檢查。
若您需要查看調用API接口配置該實例時的參數信息,請將鼠標光標移動至下一步保存任務并預檢查按鈕上,然后單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數,請單擊頁面下方的下一步保存任務并預檢查。
說明在遷移任務正式啟動之前,會先進行預檢查。只有預檢查通過后,才能成功啟動遷移任務。
如果預檢查失敗,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
如果預檢查產生警告:
對于不可以忽略的檢查項,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
對于可以忽略無需修復的檢查項,您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查,跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項,可能會導致數據不一致等問題,給業務帶來風險。
預檢查通過率顯示為100%時,單擊下一步購買。
在購買頁面,選擇數據遷移實例的鏈路規格,詳細說明請參見下表。
類別
參數
說明
信息配置
資源組配置
選擇實例所屬的資源組,默認為default resource group。更多信息,請參見什么是資源管理。
鏈路規格
DTS為您提供了不同性能的遷移規格,遷移鏈路規格的不同會影響遷移速率,您可以根據業務場景進行選擇。更多信息,請參見數據遷移鏈路規格說明。
配置完成后,閱讀并選中《數據傳輸(按量付費)服務條款》。
單擊購買并啟動,并在彈出的確認對話框,單擊確定。
您可在數據遷移界面查看具體進度。