數據傳輸服務DTS(Data Transmission Service)支持將MongoDB(副本集架構或分片集群架構)同步至云原生多模數據庫Lindorm(寬表引擎)。Lindorm具有穩定、低成本、簡單易用等優勢,可以在元數據、訂單、賬單、畫像、社交等場景中,為您提供高并發、低延遲、靈活可靠的系統服務。
前提條件
云數據庫MongoDB版為副本集架構或分片集群架構。
重要若源庫為分片集群架構的云數據庫MongoDB版,則需為所有Shard節點申請連接地址,且各Shard的賬號和密碼需保持一致。申請方法,請參見申請Shard或ConfigServer節點連接地址。
已創建存儲空間大于源云數據庫MongoDB版的目標云原生多模數據庫Lindorm實例,且數據庫引擎為寬表引擎,創建方式請參見創建實例。
說明建議目標實例的存儲空間比源數據庫已使用的存儲空間大10%。
已根據業務需求在Lindorm中創建寬表,創建方式請參見通過Lindorm-cli連接并使用寬表引擎或通過Lindorm Shell訪問寬表引擎。
說明若Lindorm中的寬表是用HBase創建的,建議您為表添加列映射關系(即寬表的列為普通列),詳情請參見HBase表添加列映射示例。
注意事項
類型 | 說明 |
源庫限制 |
|
其他限制 |
|
費用說明
同步類型 | 鏈路配置費用 |
全量數據同步 | 不收費。 |
增量數據同步 | 收費,詳情請參見計費概述。 |
同步類型說明
同步類型 | 說明 |
全量同步 | 將源云數據庫MongoDB版同步對象的存量數據全部同步到目標云原生多模數據庫Lindorm中。 說明 支持全量同步DATABASE和COLLECTION中的數據。 |
增量同步 | 在全量同步的基礎上,將源云數據庫MongoDB版的增量更新同步到目標云原生多模數據庫Lindorm中。 說明
|
數據庫賬號的權限要求
數據庫 | 所需權限 | 賬號創建及授權方式 |
源云數據庫MongoDB版 | 待同步庫、admin庫和local庫的read權限。 | |
目標云原生多模數據庫Lindorm | 目標namespace的read和write權限。 |
操作步驟
進入目標地域的同步任務列表頁面(二選一)。
通過DTS控制臺進入
登錄數據傳輸服務DTS控制臺。
在左側導航欄,單擊數據同步。
在頁面左上角,選擇同步實例所屬地域。
通過DMS控制臺進入
說明實際操作可能會因DMS的模式和布局不同,而有所差異。更多信息,請參見極簡模式控制臺和自定義DMS界面布局與樣式。
登錄DMS數據管理服務。
在頂部菜單欄中,選擇
。在同步任務右側,選擇同步實例所屬地域。
單擊創建任務,進入任務配置頁面。
可選:在頁面右上角,單擊試用新版配置頁。
說明若您已進入新版配置頁(頁面右上角的按鈕為返回舊版配置頁),則無需執行此操作。
新版配置頁和舊版配置頁部分參數有差異,建議使用新版配置頁。
配置源庫及目標庫信息。
類別
配置
說明
無
任務名稱
DTS會自動生成一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便于后續識別。
源庫信息
選擇已有連接信息
您可以按實際需求,選擇是否使用已有數據庫實例。
如使用已有實例,下方數據庫信息將自動填入,您無需重復輸入。
如不使用已有實例,您需要配置下方的數據庫信息。
說明您可以在數據連接管理頁面或新版配置頁面,將數據庫錄入DTS。更多信息,請參見數據連接管理。
DMS控制臺的配置項為選擇DMS數據庫實例,您可以單擊新增DMS數據庫實例或在控制臺首頁將數據庫錄入DMS。更多信息,請參見云數據庫錄入和他云/自建數據庫錄入。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇源云數據庫MongoDB版實例所屬地域。
是否跨阿里云賬號
本示例為同一阿里云賬號間的同步,選擇不跨賬號。
架構類型
本示例選擇副本集架構。
說明若您的源云數據庫MongoDB版為分片集群架構,您還需要填寫Shard賬號和Shard密碼。
遷移方式
請根據實際情況,選擇增量數據同步的方式。
Oplog(推薦):
若源庫已開啟Oplog日志,則支持此選項。
說明本地自建MongoDB和云數據庫MongoDB版默認已開啟Oplog日志,且使用此方式同步增量數據時增量同步任務的延遲較小(拉取日志的速度較快),因此推薦選擇Oplog。
ChangeStream:
若源庫已開啟變更流(Change Streams),則支持此選項。
說明源庫為Amazon DocumentDB(非彈性集群)時,僅支持選擇ChangeStream。
源庫架構類型選擇為分片集群架構,無需填寫Shard賬號和Shard密碼。
實例ID
選擇源云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入源云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱,若未修改過則為默認的admin。
數據庫賬號
填入源云數據庫MongoDB版實例的數據庫賬號,權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
連接方式
DTS支持非加密連接、SSL安全連接和Mongo Atlas SSL三種連接方式。連接方式的選項與接入方式和架構類型有關,請以控制臺為準。
說明架構類型為分片集群架構,且遷移方式為Oplog的MongoDB數據庫,不支持SSL安全連接。
若源庫為自建(接入方式不為云實例)副本集架構的MongoDB數據庫,并且選擇了SSL安全連接,DTS還支持上傳CA證書對連接進行校驗。
目標庫信息
選擇已有連接信息
您可以按實際需求,選擇是否使用已有數據庫實例。
如使用已有實例,下方數據庫信息將自動填入,您無需重復輸入。
如不使用已有實例,您需要配置下方的數據庫信息。
說明您可以在數據連接管理頁面或新版配置頁面,將數據庫錄入DTS。更多信息,請參見數據連接管理。
DMS控制臺的配置項為選擇DMS數據庫實例,您可以單擊新增DMS數據庫實例或在控制臺首頁將數據庫錄入DMS。更多信息,請參見云數據庫錄入和他云/自建數據庫錄入。
數據庫類型
選擇Lindorm。
接入方式
選擇云實例。
實例地區
選擇目標Lindorm所屬的地域。
實例ID
選擇目標Lindorm的實例ID。
數據庫賬號
填入目標Lindorm的數據庫賬號,權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
配置完成后,在頁面下方單擊測試連接以進行下一步。
說明請確保DTS服務的IP地址段能夠被自動或手動添加至源庫和目標庫的安全設置中,以允許DTS服務器的訪問。更多信息,請參見添加DTS服務器的IP地址段。
若源庫或目標庫為自建數據庫(接入方式不是云實例),則還需要在彈出的DTS服務器訪問授權對話框單擊測試連接。
配置任務對象。
在對象配置頁面,配置待同步的對象。
配置
說明
同步類型
固定選中增量同步。僅支持選中全量同步,不支持庫表結構同步。預檢查完成后,DTS會將源實例中待同步對象的數據在目標集群中初始化,作為后續增量同步數據的基線數據。
目標已存在表的處理模式
無需配置,保持默認即可。
目標庫對象名稱大小寫策略
您可以配置目標實例中同步對象的庫名和集合名的英文大小寫策略。默認情況下選擇DTS默認策略,您也可以選擇與源庫或目標庫默認策略保持一致。更多信息,請參見目標庫對象名稱大小寫策略。
源庫對象
在源庫對象框中單擊待同步對象,然后單擊將其移動至已選擇對象框。
說明同步對象的選擇粒度為集合。
已選擇對象
若目標庫中的寬表是通過Lindorm SQL創建的,需要通過配置新增列的方式同步數據,未配置的列不會同步至目標庫。
編輯庫名映射。
右鍵單擊已選擇對象中的待同步集合所屬的庫。
將Schema名稱修改為Lindorm中目標庫的名稱。
可選:在勾選所需同步的DML操作中選擇所需增量同步的操作。
單擊確定。
編輯表名映射。
右擊已選擇對象中的待同步的集合。
將表名稱修改為Lindorm中目標表的名稱。
可選:設置過濾條件,設置方法請參見設置過濾條件。
可選:在勾選所需同步的DML操作中選擇所需增量同步的操作。
配置MongoDB中需要同步的字段(Field)。
單擊+ 新增列。
填寫列名稱。
說明此處填寫的是Lindorm中目標表的列名。
若目標表是用SQL創建的,列名稱填寫的是Lindorm中目標表的列名。
若目標表是用HBase創建的且需要使用新增列功能,在修改列名稱前您需要提前添加列映射關系,詳情請參見HBase表添加列映射示例。列名稱填寫內容如下:
該列是主鍵:填寫為ROW。
該列不是主鍵:填寫格式為列族:列名,如person:name。
選擇列數據的類型。
可選:配置列數據的長度和精度。
在賦值下方的文本框中填寫
bson_value()
表達式,詳情請參見賦值配置示例。重要在配置
bson_value()
表達式時,需要按照層級關系配置到最小子字段,否則可能會導致數據丟失或任務失敗。單擊確定。
單擊下一步高級配置,進行高級參數配置。
配置
說明
選擇調度該任務的專屬集群
DTS默認將任務調度到共享集群上,您無需選擇。若您希望任務更加穩定,可以購買專屬集群來運行DTS同步任務。更多信息,請參見什么是DTS專屬集群。
源庫、目標庫無法連接后的重試時間
在同步任務啟動后,若源庫或目標庫連接失敗則DTS會報錯,并會立即進行持續的重試連接,默認持續重試時間為720分鐘,您也可以在取值范圍(10~1440分鐘)內自定義重試時間,建議設置30分鐘以上。如果DTS在設置的重試時間內重新連接上源庫、目標庫,同步任務將自動恢復。否則,同步任務將會失敗。
說明針對同源或者同目標的多個DTS實例,如DTS實例A和DTS實例B,設置網絡重試時間時A設置30分鐘,B設置60分鐘,則重試時間以低的30分鐘為準。
由于連接重試期間,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功能。
說明若目標表是用HBase創建的,請注意如下事項:
ETL的語法包括需要配置的列和需要排除的列,在同步過程中會將MongoDB已配置ETL的文檔(Document)所有頂層字段,存儲在HBase表默認的列族f中。以下示例表示:將除_id和name兩個頂層元素的其他元素作為動態列寫入目標表。更多信息,請參見HBase表同步示例(ETL)。
script:e_expand_bson_value("*", "_id,name")
若您需要同時使用新增列和ETL功能,請確保Lindorm中的數據不會重復。
新增列和ETL功能均未配置的列不會同步至目標庫。
監控告警
是否設置告警,當同步失敗或延遲超過閾值后,將通知告警聯系人。
不設置:不設置告警。
設置:設置告警,您還需要設置告警閾值和告警聯系人。更多信息,請參見在配置任務過程中配置監控告警。
保存任務并進行預檢查。
若您需要查看調用API接口配置該實例時的參數信息,請將鼠標光標移動至下一步保存任務并預檢查按鈕上,然后單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數,請單擊頁面下方的下一步保存任務并預檢查。
說明在同步作業正式啟動之前,會先進行預檢查。只有預檢查通過后,才能成功啟動同步作業。
如果預檢查失敗,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
如果預檢查產生警告:
對于不可以忽略的檢查項,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
對于可以忽略無需修復的檢查項,您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查,跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項,可能會導致數據不一致等問題,給業務帶來風險。
購買實例。
預檢查通過率顯示為100%時,單擊下一步購買。
在購買頁面,選擇數據同步實例的計費方式、鏈路規格,詳細說明請參見下表。
類別
參數
說明
信息配置
計費方式
預付費(包年包月):在新建實例時支付費用。適合長期需求,價格比按量付費更實惠,且購買時長越長,折扣越多。
后付費(按量付費):按小時扣費。適合短期需求,用完可立即釋放實例,節省費用。
資源組配置
實例所屬的資源組,默認為default resource group。更多信息,請參見什么是資源管理。
鏈路規格
DTS為您提供了不同性能的同步規格,同步鏈路規格的不同會影響同步速率,您可以根據業務場景進行選擇。更多信息,請參見數據同步鏈路規格說明。
訂購時長
在預付費模式下,選擇包年包月實例的時長和數量,包月可選擇1~9個月,包年可選擇1年、2年、3年和5年。
說明該選項僅在付費類型為預付費時出現。
配置完成后,閱讀并勾選《數據傳輸(按量付費)服務條款》。
單擊購買并啟動,并在彈出的確認對話框,單擊確定。
您可在數據同步界面查看具體任務進度。
HBase表添加列映射示例
本示例以在SQL Shell上操作為例介紹。
Lindorm須為2.4.0及以上版本。
為HBase創建的表添加列映射。
ALTER TABLE test MAP DYNAMIC COLUMN f:_mongo_id_ HSTRING/HINT/..., person:name HSTRING, person:age HINT;
為HBase創建的表添加二級索引。
CREATE INDEX idx ON test(f:_mongo_id_);
HBase表同步示例(ETL)
MongoDB文檔(Document)
{
"_id" : 0,
"person" : {
"name" : "cindy0",
"age" : 0,
"student" : true
}
}
ETL數據處理語句
script:e_expand_bson_value("*", "_id")
同步結果
賦值配置示例
源MongoDB數據結構
{
"_id":"62cd344c85c1ea6a2a9f****",
"person":{
"name":"neo",
"age":"26",
"sex":"male"
}
}
目標Lindorm表結構
列名稱 | 類型 |
id | STRING |
person_name | STRING |
person_age | INT |
新增列配置
請按照層級關系正確配置bson_value()
表達式,否則可能會導致數據丟失或任務失敗。例如,若您配置的表達式為bson_value("person")
,DTS將無法把源端person
的子字段(name、age、sex)的增量變更數據寫入到目標端。
列名稱 | 類型 | 賦值 |
id | STRING | bson_value("_id") |
person_name | STRING | bson_value("person","name") |
person_age | BIGINT | bson_value("person","age") |