本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業務造成影響,請務必仔細閱讀。
本文介紹如何使用數據傳輸服務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會自動生成一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便于后續識別。
源庫信息
選擇已有連接信息
您可以按實際需求,選擇是否使用已有數據庫實例。
如使用已有實例,下方數據庫信息將自動填入,您無需重復輸入。
如不使用已有實例,您需要配置下方的數據庫信息。
說明您可以在數據連接管理頁面或新版配置頁面,將數據庫錄入DTS。更多信息,請參見數據連接管理。
DMS控制臺的配置項為選擇DMS數據庫實例,您可以單擊新增DMS數據庫實例或在控制臺首頁將數據庫錄入DMS。更多信息,請參見云數據庫錄入和他云/自建數據庫錄入。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇源云數據庫MongoDB版所屬地域。
是否跨阿里云賬號
本示例使用當前阿里云賬號下的數據庫實例,需選擇不跨賬號。
架構類型
單節點架構的MongoDB需選擇副本集架構。
遷移方式
源庫為單節點架構的MongoDB時不支持增量遷移,保持默認的Oplog即可。
實例ID
選擇源云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入源云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱,若未修改過則默認為admin。
數據庫賬號
填入源云數據庫MongoDB版的數據庫賬號,權限要求,請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
連接方式
DTS支持非加密連接、SSL安全連接和Mongo Atlas SSL三種連接方式。連接方式的選項與接入方式和架構類型有關,請以控制臺為準。
說明架構類型為分片集群架構,且遷移方式為Oplog的MongoDB數據庫,不支持SSL安全連接。
若源庫為自建(接入方式不為云實例)副本集架構的MongoDB數據庫,并且選擇了SSL安全連接,DTS還支持上傳CA證書對連接進行校驗。
目標庫信息
選擇已有連接信息
您可以按實際需求,選擇是否使用已有數據庫實例。
如使用已有實例,下方數據庫信息將自動填入,您無需重復輸入。
如不使用已有實例,您需要配置下方的數據庫信息。
說明您可以在數據連接管理頁面或新版配置頁面,將數據庫錄入DTS。更多信息,請參見數據連接管理。
DMS控制臺的配置項為選擇DMS數據庫實例,您可以單擊新增DMS數據庫實例或在控制臺首頁將數據庫錄入DMS。更多信息,請參見云數據庫錄入和他云/自建數據庫錄入。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇目標云數據庫MongoDB版所屬地域。
是否跨阿里云賬號
本示例使用當前阿里云賬號下的數據庫實例,需選擇不跨賬號。
架構類型
根據您的業務需求選擇架構,取值:
實例ID
選擇目標云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入目標云數據庫MongoDB版數據庫賬號所屬的數據庫名稱,若未修改過則默認為admin。
數據庫賬號
填入目標云數據庫MongoDB版的數據庫賬號,權限要求,請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
連接方式
DTS支持非加密連接、SSL安全連接和Mongo Atlas SSL三種連接方式。連接方式的選項與接入方式和架構類型有關,請以控制臺為準。
說明架構類型為分片集群架構的MongoDB數據庫,不支持SSL安全連接。
若目標庫為自建(接入方式不為云實例)副本集架構的MongoDB數據庫,并且選擇了SSL安全連接,DTS還支持上傳CA證書對連接進行校驗。
配置完成后,在頁面下方單擊測試連接以進行下一步。
說明請確保DTS服務的IP地址段能夠被自動或手動添加至源庫和目標庫的安全設置中,以允許DTS服務器的訪問。更多信息,請參見添加DTS服務器的IP地址段。
若源庫或目標庫為自建數據庫(接入方式不是云實例),則還需要在彈出的DTS服務器訪問授權對話框單擊測試連接。
配置任務對象。
在對象配置頁面,配置待遷移的對象。
配置
說明
遷移類型
同時選中庫表結構遷移和全量遷移。
說明本場景暫不支持增量遷移,為保障數據一致性,數據遷移期間請勿在源實例中寫入新的數據。
更多信息,請參見遷移類型說明。
目標已存在表的處理模式
- 預檢查并報錯攔截:檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合,則通過該檢查項目;如果目標數據庫中有同名的集合,則在預檢查階段提示錯誤,數據遷移任務不會被啟動。 說明 如果目標庫中同名的集合不方便刪除或重命名,您可以更改該集合在目標庫中的名稱,請參見庫表列名映射。
- 忽略報錯并繼續執行:跳過目標數據庫中是否有同名集合的檢查項。 警告 選擇為忽略報錯并繼續執行,可能導致數據不一致,給業務帶來風險,例如:
- 在目標庫遇到與源庫主鍵的值相同的記錄,則會保留目標庫中的該條記錄,即源庫中的該條記錄不會遷移至目標庫中。
- 可能會導致無法初始化數據、只能遷移部分的數據或遷移失敗。
目標庫對象名稱大小寫策略
您可以配置目標實例中遷移對象的庫名、集合名的英文大小寫策略。默認情況下選擇DTS默認策略,您也可以選擇與源庫、目標庫默認策略保持一致。更多信息,請參見目標庫對象名稱大小寫策略。
源庫對象
在源庫對象框中單擊待遷移的對象,然后單擊將其移動到已選擇對象框。
說明遷移對象的選擇粒度為DATABASE、COLLECTION。
已選擇對象
如需更改遷移對象在目標實例中的名稱,請右擊已選擇對象中的遷移對象進行修改。設置方式,請參見庫表列名映射。
如需移除已選擇的遷移對象,請在已選擇對象框中單擊待遷移的對象,然后單擊將其移動到源庫對象框。
說明如需按庫或集合級別選擇增量遷移的操作,請在已選擇對象中右擊待遷移的對象,并在彈出的對話框中進行選擇。
如需設置條件過濾數據(全量遷移階段支持條件過濾數據,增量遷移階段不支持),請在已選擇對象中右擊待遷移的表,并在彈出的對話框中進行設置。設置方法,請參見設置過濾條件。
如果使用了對象名映射功能(指定用于接收數據的數據庫或集合),可能會導致依賴這個對象的其他對象遷移失敗。
- 預檢查并報錯攔截:檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合,則通過該檢查項目;如果目標數據庫中有同名的集合,則在預檢查階段提示錯誤,數據遷移任務不會被啟動。
單擊下一步高級配置,進行高級參數配置。
配置
說明
選擇調度該任務的專屬集群
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將掃描源庫待遷移數據中主鍵的數據類型。
是否限制增量遷移速率
您也可以根據實際情況,選擇是否對增量遷移任務進行限速設置(設置每秒增量遷移的行數RPS和每秒增量遷移的數據量(MB)BPS),以緩解目標庫的壓力。
說明僅當遷移類型選擇了增量遷移時才可以配置。
環境標簽
您可以根據實際情況,選擇用于標識實例的環境標簽。本示例無需選擇。
配置ETL功能
選擇是否配置ETL功能。關于ETL的更多信息,請參見什么是ETL。
是:配置ETL功能,并在文本框中填寫數據處理語句,詳情請參見在DTS遷移或同步任務中配置ETL。
否:不配置ETL功能。
監控告警
是否設置告警,當遷移失敗或延遲超過閾值后,將通知告警聯系人。
不設置:不設置告警。
設置:設置告警,您還需要設置告警閾值和告警聯系人。更多信息,請參見在配置任務過程中配置監控告警。
單擊下一步數據校驗,進行數據校驗任務配置。
若您需要使用數據校驗功能,配置方法請參見配置數據校驗。
保存任務并進行預檢查。
若您需要查看調用API接口配置該實例時的參數信息,請將鼠標光標移動至下一步保存任務并預檢查按鈕上,然后單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數,請單擊頁面下方的下一步保存任務并預檢查。
說明在遷移任務正式啟動之前,會先進行預檢查。只有預檢查通過后,才能成功啟動遷移任務。
如果預檢查失敗,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
如果預檢查產生警告:
對于不可以忽略的檢查項,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
對于可以忽略無需修復的檢查項,您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查,跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項,可能會導致數據不一致等問題,給業務帶來風險。
購買實例。
預檢查通過率顯示為100%時,單擊下一步購買。
在購買頁面,選擇數據遷移實例的鏈路規格,詳細說明請參見下表。
類別
參數
說明
信息配置
資源組配置
選擇實例所屬的資源組,默認為default resource group。更多信息,請參見什么是資源管理。
鏈路規格
DTS為您提供了不同性能的遷移規格,遷移鏈路規格的不同會影響遷移速率,您可以根據業務場景進行選擇。更多信息,請參見數據遷移鏈路規格說明。
配置完成后,閱讀并選中《數據傳輸(按量付費)服務條款》。
單擊購買并啟動,并在彈出的確認對話框,單擊確定。
您可在數據遷移界面查看具體進度。