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