Data Transmission Service：ApsaraDB for MongoDB同步至雲原生多模資料庫Lindorm

前提條件

• ApsaraDB for MongoDB所屬地區為德國（法蘭克福）。

• ApsaraDB for MongoDB為複本集架構或分區叢集架構。

  重要

  若源庫為分區叢集架構的ApsaraDB for MongoDB，則需為Shard節點申請串連地址，且各Shard的帳號和密碼需保持一致。申請方法，請參見申請Shard或ConfigServer節點串連地址。

• 已建立儲存空間大於源ApsaraDB for MongoDB的目標雲原生多模資料庫Lindorm執行個體，且資料庫引擎是為寬表引擎，建立方式請參見建立執行個體。

  說明

  建議目標執行個體的儲存空間比來源資料庫已使用的儲存空間大10%。

• 已根據業務需求在Lindorm中建立寬表，建立方式請參見通過Lindorm-cli串連並使用寬表引擎或通過Lindorm Shell訪問寬表引擎。

  說明

  若Lindorm中的寬表是用HBase建立的，建議您為表添加列映射關係（即寬表的列為普通列），詳情請參見HBase表添加列映射樣本。

注意事項

費用說明

同步類型說明

資料庫帳號的許可權要求

操作步驟

1. 進入同步任務的列表頁面。

   1. 登入Data Management服務。

   2. 在頂部功能表列中，單擊整合與開發（DTS）。

   3. 在左側導覽列，選擇資料轉送（DTS） > 資料同步。

   說明

   • 實際操作可能會因DMS的模式和布局不同，而有所差異。更多資訊。請參見極簡模式控制台和自訂DMS介面布局與樣式。

   • 您也可以登入新版DTS同步工作清單頁面。

2. 在同步任務右側，選擇同步執行個體所屬地區。

   說明

   新版DTS同步工作清單頁面，需要在頁面左上方選擇同步執行個體所屬地區。

3. 單擊建立任務，配置源庫及目標庫資訊。

   類別	配置	說明
   無	任務名稱	DTS會自動產生一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便於後續識別。
   源庫資訊	選擇已有的DMS資料庫執行個體（可選，如未建立可忽略此處選擇，直接在下方設定資料庫資訊即可）	您可以按實際需求，選擇是否使用已有執行個體。 如使用已有執行個體，下方資料庫資訊將自動填入，您無需重複輸入。 如不使用已有執行個體，您需要輸入下方的資料庫資訊。
   	資料庫類型	選擇MongoDB。
   	接入方式	選擇雲執行個體。
   	執行個體地區	選擇源ApsaraDB for MongoDB執行個體所屬地區。
   	是否跨阿里雲帳號	本樣本為同一阿里雲帳號間的同步，選擇不跨帳號。
   	架構類型	本樣本選擇複本集架構。 說明 若您的源ApsaraDB for MongoDB為分區叢集架構，您還需要填寫shard帳號和shard密碼。
   	執行個體ID	選擇源ApsaraDB for MongoDB執行個體ID。
   	鑒權資料庫名稱	填入源ApsaraDB for MongoDB執行個體資料庫帳號所屬的資料庫名稱，若未修改過則為預設的admin。
   	資料庫帳號	填入源ApsaraDB for MongoDB執行個體的資料庫帳號，許可權要求請參見資料庫帳號的許可權要求。
   	資料庫密碼	填入該資料庫帳號對應的密碼。
   	串連方式	請根據實際情況選擇非加密串連或SSL安全連線。 說明 僅複本集架構的MongoDB資料庫支援此配置項。 若源庫為自建複本集架構的MongoDB資料庫，並且選擇了SSL安全連線，DTS還支援上傳CA認證對串連進行校正。
   目標庫資訊	選擇已有的DMS資料庫執行個體（可選，如未建立可忽略此處選擇，直接在下方設定資料庫資訊即可）	您可以按實際需求，選擇是否使用已有執行個體。 如使用已有執行個體，下方資料庫資訊將自動填入，您無需重複輸入。 如不使用已有執行個體，您需要輸入下方的資料庫資訊。
   	資料庫類型	選擇Lindorm。
   	接入方式	選擇雲執行個體。
   	執行個體地區	選擇目標Lindorm所屬的地區。
   	執行個體ID	選擇目標Lindorm的執行個體ID。
   	資料庫帳號	填入目標Lindorm的資料庫帳號，許可權要求請參見資料庫帳號的許可權要求。
   	資料庫密碼	填入該資料庫帳號對應的密碼。

4. 配置完成後，單擊頁面下方的測試連接以進行下一步。

   如果源或目標資料庫是阿里雲資料庫執行個體（例如RDS MySQL、ApsaraDB for 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網關/智能網關）的方式接入。

5. 配置任務對象及進階配置。

   配置	說明
   同步類型	固定選中增量同步處理。僅支援選中全量同步，不支援庫表結構同步。預檢查完成後，DTS會將源執行個體中待同步對象的資料在目的地組群中初始化，作為後續增量同步處理資料的基準資料。
   目標已存在表的處理模式	預檢查並報錯攔截：檢查目標資料庫中是否有同名的集合。如果目標資料庫中沒有同名的集合，則通過該檢查專案；如果目標資料庫中有同名的集合，則在預檢查階段提示錯誤，資料同步任務不會被啟動。 說明 如果目標庫中同名的集合不方便刪除或重新命名，您可以更改該集合在目標庫中的名稱，詳情請參見設定同步對象在目標執行個體中的名稱。 忽略報錯並繼續執行：跳過目標資料庫中是否有同名集合的檢查項。 警告 選擇為忽略報錯並繼續執行，可能導致資料不一致，給業務帶來風險，例如： 在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄，則會保留目標庫中的該條記錄，即源庫中的該條記錄不會同步至目標庫中。 可能會導致無法初始化資料、只能同步部分的資料或同步失敗。
   目標庫對象名稱大小寫策略	您可以配置目標執行個體中同步對象的庫名和集合名的英文大小寫策略。預設情況下選擇DTS預設策略，您也可以選擇與源庫或目標庫預設策略保持一致。更多資訊，請參見目標庫對象名稱大小寫策略。
   源庫對象	在源庫對象框中單擊待同步對象，然後單擊將其移動至已選擇對象框。 說明 同步對象的選擇粒度為集合。
   已選擇對象	若目標庫中的寬表是通過Lindorm SQL建立的，需要通過配置新增列的方式同步資料，未配置的列不會同步至目標庫。 編輯庫名映射。 按右鍵已選擇對象中的待同步集合所屬的庫。 將Schema名稱修改為Lindorm中目標庫的名稱。 可選：在勾選所需同步的DML操作中選擇所需增量同步處理的操作。 單擊確定。 編輯表名映射。 右擊已選擇對象中的待同步的集合。 將表名稱修改為Lindorm中目標表的名稱。 可選：設定過濾條件，設定方法請參見設定過濾條件。 可選：在勾選所需同步的DML操作中選擇所需增量同步處理的操作。 配置MongoDB中需要同步的欄位（Field）。 單擊+ 新增列。 填寫列名稱。 說明 此處填寫的是Lindorm中目標表的列名。 若目標表是用SQL建立的，列名稱填寫的是Lindorm中目標表的列名。 若目標表是用HBase建立的且需要使用新增列功能，在修改列名稱前您需要提前添加列映射關係，詳情請參見HBase表添加列映射樣本。列名稱填寫內容如下： 該列是主鍵：填寫為ROW。 該列不是主鍵：填寫格式為列族:列名，如person:name。 選擇列資料的類型。 可選：配置列資料的長度和精度。 在賦值下方的文字框中填寫bson_value()運算式，詳情請參見賦值配置樣本。 重要 在配置bson_value()運算式時，需要按照層級關係配置到最小子欄位，否則可能會導致資料丟失或任務失敗。 重複操作，將待遷移的欄位與目標表的欄位進行逐一映射。 單擊確定。

6. 單擊下一步高級配置，進行進階配置。

   配置	說明
   選擇調度該任務的專屬叢集	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），以緩解目標庫的壓力。 說明 僅當同步類型選擇了全量同步時才可以配置。
   是否限制增量同步處理速率	您也可以根據實際情況，選擇是否對增量同步處理任務進行限速設定（設定每秒增量同步處理的行數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功能均未配置的列不會同步至目標庫。

7. 儲存任務並進行預檢查。

   • 若您需要查看調用API介面配置該執行個體時的參數資訊，請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上，然後單擊氣泡中的預覽OpenAPI參數。

   • 若您無需查看或已完成查看API參數，請單擊頁面下方的下一步儲存任務並預檢查。

   說明

   • 在同步作業正式啟動之前，會先進行預檢查。只有預檢查通過後，才能成功啟動同步作業。

   • 如果預檢查失敗，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。

   • 如果預檢查產生警告：

     • 對於不可以忽略的檢查項，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。

     • 對於可以忽略無需修複的檢查項，您可以依次單擊點擊確認警示詳情、確認屏蔽、確定、重新進行預檢查，跳過警示檢查項重新進行預檢查。如果選擇屏蔽警示檢查項，可能會導致資料不一致等問題，給業務帶來風險。

8. 預檢查通過率顯示為100%時，單擊下一步購買。

9. 在購買頁面，選擇資料同步執行個體的計費方式、鏈路規格，詳細說明請參見下表。

   類別	參數	說明
   資訊配置	計費方式	預付費（訂用帳戶）：在建立執行個體時支付費用。適合長期需求，價格比隨用隨付更實惠，且購買時間長度越長，折扣越多。 後付費（隨用隨付）：按小時計費。適合短期需求，用完可立即釋放執行個體，節省費用。
   	資源群組配置	執行個體所屬的資源群組，預設為default resource group。更多資訊，請參見什麼是資源管理。
   	鏈路規格	DTS為您提供了不同效能的同步規格，同步鏈路規格的不同會影響同步速率，您可以根據業務情境進行選擇。更多資訊，請參見資料同步鏈路規格說明。
   	訂購時間長度	在預付費模式下，選擇訂用帳戶執行個體的時間長度和數量，包月可選擇1~9個月，包年可選擇1年、2年、3年和5年。 說明 該選項僅在付費類型為預付費時出現。

10. 配置完成後，閱讀並勾選《資料轉送（隨用隨付）服務條款》。

11. 單擊購買並啟動，同步任務正式開始，您可在資料同步介面查看具體任務進度。

12. 預檢查通過率顯示為100%時，單擊下一步購買。

HBase表添加列映射樣本

本樣本以在SQL Shell上操作為例介紹。

1. 為HBase建立的表添加列映射。

   ALTER TABLE test MAP DYNAMIC COLUMN f:_mongo_id_ HSTRING/HINT/..., person:name HSTRING, person:age HINT;

2. 為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表結構

新增列配置