全部產品
Search
文件中心

Data Transmission Service:ApsaraDB for MongoDB遷移至雲原生多模資料庫Lindorm

更新時間:Feb 11, 2025

本文介紹如何使用Data Transmission Service,將ApsaraDB for MongoDB(複本集架構或分區叢集架構)遷移至雲原生多模資料庫Lindorm。

前提條件

  • 當前僅支援德國(法蘭克福)地區間的遷移任務。

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

    重要

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

  • 已建立目標雲原生多模資料庫Lindorm執行個體,且資料庫引擎為寬表引擎,建立方式請參見建立執行個體

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

    說明

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

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

注意事項

類型

說明

源庫限制

  • 頻寬要求:源庫所屬的伺服器需具備足夠出口頻寬,否則將影響資料移轉速率。

  • 待遷移的集合需具備主鍵或唯一約束,且欄位具有唯一性,否則可能會導致目標資料庫中出現重複資料。

  • 如遷移對象為集合層級,且需進行編輯(如集合的名稱映射),則單次遷移任務僅支援遷移至多1000個集合。當超出數量限制,任務提交後會顯示請求報錯,此時建議您拆分待遷移的集合,分批配置多個任務。

  • 源庫為Azure Cosmos DB for MongoDB或彈性叢集的Amazon DocumentDB時,僅支援全量遷移。

  • 如需進行增量遷移:

    源庫需開啟Oplog日誌,並確保Oplog日誌至少保留7天以上;或者開啟變更流(Change Streams),並確保DTS能夠通過Change Streams訂閱到源庫最近7天內的資料變更。否則可能會因無法擷取源庫的資料變更而導致任務失敗,極端情況下甚至可能會導致資料不一致或丟失。由此導致的問題,不在DTS的SLA保障範圍內。

    重要
    • 建議通過Oplog日誌擷取源庫的資料變更。

    • 僅4.0及以上版本的MongoDB支援通過Change Streams擷取資料變更。

    • 源庫為Amazon DocumentDB(非彈性叢集)時,需要手動開啟Change Streams,並在配置任務時將遷移方式選擇為ChangeStream,將架構類型選擇為分區叢集架構

  • 若源MongoDB為分區叢集架構的執行個體,則待遷移集合中的_id欄位需具有唯一性,否則可能會導致資料不一致。

  • 若源MongoDB為分區叢集架構的執行個體,則源Mongos節點的數量不能超過10個。

  • 源庫的操作限制:

    • 在全量遷移階段,請勿對庫或集合執行結構變更操作(包含數群組類型資料的更新),否則會導致資料移轉任務失敗或源庫與目標庫的資料不一致。

    • 如僅執行全量資料移轉,請勿向源執行個體中寫入新的資料,否則會導致源庫與目標庫的資料不一致。

  • 暫不支援遷移包含TTL(Time To Live)索引的集合。若待遷移的資料庫中包含TTL索引,則可能會導致資料不一致。

  • 當源庫為分區叢集架構的MongoDB時,若源庫的均衡器Balancer存在均衡資料的行為,則可能會導致執行個體產生延遲。

其他限制

  • 不支援遷移admin和local庫中的資料。

  • 目標雲原生多模資料庫Lindorm的集合不能有名稱為_id_value的欄位,否則會導致遷移失敗。

  • 如果需要增量遷移UPDATE或DELETE操作,有如下限制:

    • 若寬表是通過Lindorm SQL建立的,須在建表時添加一列非主鍵列_mongo_id_,類型由MongoDB中_id的類型決定,同時需要為該列建立二級索引。

    • 若寬表是通過HBase介面建立的,須在建表時添加一列非主鍵列且列族為f的列_mongo_id_,類型由MongoDB中_id的類型決定,同時需要為該列建立二級索引。若您需要同時使用新增列和ETL功能,請確保Lindorm中的資料不會重複。

  • 不保留事務資訊,即源庫中的事務遷移到目標庫時會轉變為單條的記錄。

  • 執行資料移轉前需評估源庫和目標庫的效能,同時建議在業務低峰期執行資料移轉。否則全量資料移轉時DTS佔用源和目標庫一定讀寫資源,可能會導致資料庫的負載上升。

  • 由於全量資料移轉會並發執行INSERT操作,導致目標資料庫的集合產生片段,因此全量遷移完成後目標資料庫的集合儲存空間會大於源執行個體的集合儲存空間。

  • 請確認DTS對資料類型為FLOAT或DOUBLE的列的遷移精度是否符合業務預期。DTS會通過ROUND(COLUMN,PRECISION)來讀取這兩類列的值。如果沒有明確定義其精度,DTS對FLOAT的遷移精度為38位,對DOUBLE的遷移精度為308位。

  • DTS會嘗試恢複七天之內遷移失敗任務。因此在業務切換至目標執行個體前,請務必結束或釋放該任務,或者用revoke命令回收DTS訪問目標執行個體帳號的寫入權限。避免該任務被自動回復後,源端資料覆蓋目標執行個體的資料。

  • 由於DTS增量遷移的延遲時間是根據遷移到目標庫最後一條資料的時間戳記和目前時間戳對比得出,源庫長時間未執行更新操作可能導致延遲資訊不準確。如果任務顯示的延遲時間過大,您可以在源庫執行一個更新操作來更新延遲資訊。

  • 若執行個體運行失敗,DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中,可能會對該執行個體進行重啟、調整參數等操作。

    說明

    在調整參數時,僅會修改執行個體的參數,不會對資料庫中的參數進行修改。可能修改的參數,包括但不限於修改執行個體參數中的參數。

費用說明

遷移類型

鏈路配置費用

公網流量費用

全量資料移轉

不收費。

通過公網將資料移轉出阿里雲時將收費,詳情請參見計費概述

增量資料移轉

收費,詳情請參見計費概述

遷移類型說明

遷移類型

說明

全量遷移

將源ApsaraDB for MongoDB遷移對象的存量資料全部遷移到目標雲原生多模資料庫Lindorm中。

說明

支援全量遷移DATABASE和COLLECTION中的資料。

增量遷移

在全量遷移的基礎上,將源ApsaraDB for MongoDB的累加式更新遷移到目標雲原生多模資料庫Lindorm中。

說明
  • 僅支援增量遷移在集合中插入、更新、刪除文檔的操作。

  • 在遷移累加式更新文檔的資料時,僅支援遷移使用$set命令更新的操作。

資料庫帳號的許可權要求

資料庫

全量遷移

增量遷移

帳號建立及授權方法

ApsaraDB for MongoDB

待遷移庫的read許可權。

待遷移庫、admin庫和local庫的read許可權。

MongoDB資料庫帳號許可權管理

目標雲原生多模資料庫Lindorm

雲原生多模資料庫Lindorm的read和write許可權。

使用者管理

操作步驟

本操作的目標庫以Lindorm SQL建立的寬表為例進行介紹。

  1. 進入目標地區的遷移工作清單頁面(二選一)。

    通過DTS控制台進入

    1. 登入Data Transmission Service控制台

    2. 在左側導覽列,單擊資料移轉

    3. 在頁面左上方,選擇遷移執行個體所屬地區。

    通過DMS控制台進入

    說明

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

    1. 登入Data Management服務

    2. 在頂部功能表列中,選擇整合與開發 > 資料轉送(DTS) > 資料移轉

    3. 遷移任務右側,選擇遷移執行個體所屬地區。

  2. 單擊創建任務,進入任務配置頁面。

  3. 可選:在頁面右上方,單擊試用新版配置頁

    說明
    • 若您已進入新版配置頁(頁面右上方的按鈕為返回舊版配置頁),則無需執行此操作。

    • 新版配置頁和舊版配置頁部分參數有差異,建議使用新版配置頁。

  4. 配置源庫及目標庫資訊。

    類別

    配置

    說明

    任務名稱

    DTS會自動產生一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便於後續識別。

    源庫資訊

    選擇已有串連資訊

    您可以按實際需求,選擇是否使用已有資料庫執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明
    • 您可以在資料連線管理頁面或新版配置頁面,將資料庫錄入DTS。更多資訊,請參見資料連線管理

    • DMS控制台的配置項為選擇DMS資料庫執行個體,您可以單擊新增DMS資料庫執行個體或在控制台首頁將資料庫錄入DMS。更多資訊,請參見雲資料庫錄入他雲/自建資料庫錄入

    資料庫類型

    選擇MongoDB

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇源ApsaraDB for MongoDB所屬地區。

    是否跨阿里雲帳號

    本樣本為同一阿里雲帳號間的遷移,選擇不跨帳號

    架構類型

    本樣本選擇複本集架構

    說明

    架構類型選擇則為分區叢集架構,您還需填寫Shard賬號Shard密碼

    遷移方式

    請根據實際情況,選擇增量資料移轉的方式。

    • Oplog(推薦):

      若源庫已開啟Oplog日誌,則支援此選項。

      說明

      本地自建MongoDB和ApsaraDB for MongoDB預設已開啟Oplog日誌,且使用此方式遷移增量資料時增量遷移任務的延遲較小(拉取日誌的速度較快),因此推薦選擇Oplog

    • ChangeStream:若源庫已開啟變更流(Change Streams),則支援此選項。

      說明
      • 源庫為Amazon DocumentDB(非彈性叢集)時,僅支援選擇ChangeStream

      • 源庫架構類型選擇為分區叢集架構,無需填寫Shard賬號Shard密碼

    執行個體ID

    選擇源ApsaraDB for MongoDB執行個體ID。

    鑒權資料庫名稱

    填入源ApsaraDB for MongoDB執行個體中資料庫帳號所屬的資料庫名稱,若未修改過則預設為admin。

    資料庫帳號

    填入源ApsaraDB for MongoDB的資料庫帳號。

    資料庫密碼

    填入該資料庫帳號對應的密碼。

    串連方式

    DTS支援非加密串連SSL安全連線Mongo Atlas SSL三種串連方式。串連方式的選項與接入方式架構類型有關,請以控制台為準。

    說明
    • 架構類型分區叢集架構,且遷移方式Oplog的MongoDB資料庫,不支援SSL安全連線

    • 若源庫為自建(接入方式不為雲執行個體複本集架構的MongoDB資料庫,並且選擇了SSL安全連線,DTS還支援上傳CA認證對串連進行校正。

    目標庫資訊

    選擇已有串連資訊

    您可以按實際需求,選擇是否使用已有資料庫執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明
    • 您可以在資料連線管理頁面或新版配置頁面,將資料庫錄入DTS。更多資訊,請參見資料連線管理

    • DMS控制台的配置項為選擇DMS資料庫執行個體,您可以單擊新增DMS資料庫執行個體或在控制台首頁將資料庫錄入DMS。更多資訊,請參見雲資料庫錄入他雲/自建資料庫錄入

    資料庫類型

    選擇Lindorm

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇目標雲原生多模資料庫Lindorm所屬地區。

    執行個體ID

    選擇目標雲原生多模資料庫Lindorm的執行個體ID。

    資料庫帳號

    填入目標雲原生多模資料庫Lindorm的資料庫帳號。

    資料庫密碼

    填入該資料庫帳號對應的密碼。

  5. 配置完成後,在頁面下方單擊測試連接以進行下一步

    說明
    • 請確保DTS服務的IP位址區段能夠被自動或手動添加至源庫和目標庫的安全設定中,以允許DTS伺服器的訪問。更多資訊,請參見添加DTS伺服器的IP位址區段

    • 若源庫或目標庫為自建資料庫(接入方式不是雲執行個體),則還需要在彈出的DTS伺服器訪問授權對話方塊單擊測試連接

  6. 配置任務對象。

    1. 對象配置頁面,配置待遷移的對象。

      配置

      說明

      遷移類型

      • 如果只需要進行全量遷移,請選中全量遷移

      • 如果需要進行不停機遷移,請同時選中全量遷移增量遷移

      說明

      若未選中增量遷移,為保障資料一致性,資料移轉期間請勿在源執行個體中寫入新的資料。

      目標已存在表的處理模式

      無需配置,保持預設即可。

      目標庫對象名稱大小寫策略

      您可以配置目標執行個體中遷移對象的庫名、集合名的英文大小寫策略。預設情況下選擇DTS預設策略,您也可以選擇與源庫、目標庫預設策略保持一致。更多資訊,請參見目標庫對象名稱大小寫策略

      源庫對象

      源庫對象框中單擊待遷移的集合,然後單擊向右小箭頭將其移動至已選擇對象框。

      已選擇對象

      若目標庫中的寬表是通過Lindorm SQL建立的,需要通過配置新增列的方式遷移資料,未配置的列不會遷移至目標庫。

      1. 編輯庫名映射。

        1. 按右鍵已選擇對象中的待遷移集合所屬的庫。

        2. Schema名稱修改為Lindorm中目標庫的名稱。

          image.png

        3. 可選:勾選所需同步的DML&DDL操作地區選取項目所需增量遷移的操作。

        4. 單擊確定

      2. 編輯表名映射。

        1. 右擊已選擇對象中的待遷移的集合。

        2. 表名稱修改為Lindorm中目標表的名稱。

          image.png

        3. 可選:設定過濾條件,設定方法請參見設定過濾條件

        4. 可選:勾選所需同步的DML&DDL操作地區選取項目所需增量遷移的操作。

      3. 配置MongoDB中需要遷移的欄位(Field)。

        DTS預設會對待遷移集合的資料進行映射,在賦值列配置運算式。您需要檢查運算式是否符合您的要求,並配置列名稱類型長度精度等資訊。

        1. 賦值列的bson_value()運算式中,查看該行資料在MongoDB中的欄位名稱。

          ""中的欄位,即為MongoDB中的欄位名稱。例如,運算式為bson_value("age"),則該行資料對應MongoDB中的age欄位。

        2. 可選:刪除無需遷移的欄位。

          說明

          對於無需遷移的欄位,您可以單擊該行資料後的image

        3. 配置待遷移的欄位。

          根據bson_value()運算式是否符合您的要求,進行後續操作。

          運算式符合要求的欄位

          1. 填寫列名稱

            說明

            此處填寫的是Lindorm中目標表的列名。

            • 若目標表是用SQL建立的,列名稱填寫的是Lindorm中目標表的列名。

            • 若目標表是用HBase建立的且需要使用新增列功能,在修改列名稱前您需要提前添加列映射關係,詳情請參見HBase表添加列映射樣本列名稱填寫內容如下:

              • 該列是主鍵:填寫為ROW

              • 該列不是主鍵:填寫格式為列族:列名,如person:name

          2. 選擇列資料的類型

            重要

            請務必確保目標表的資料類型與源MongoDB的資料相容。

          3. 可選:配置列資料的長度精度

          4. 重複上述操作,將相關欄位逐一進行映射。

          運算式不符合要求的欄位

          說明

          例如,含層級關係(父子結構)的欄位。

          1. 操作列,單擊該行資料後的image

          2. 單擊+ 新增列image

          3. 配置列名稱類型長度精度

          4. 賦值下方的文字框中填寫bson_value()運算式,詳情請參見賦值配置樣本

            重要
            • 目標表的主鍵列必須賦值為bson_value("_id")

            • 在配置bson_value()運算式時,需要按照層級關係配置到最小子欄位,否則可能會導致資料丟失或任務失敗。

          5. 重複上述操作,將相關欄位逐一進行映射。

      4. 單擊確定

    2. 單擊下一步高級配置,進行進階參數配置。

      配置

      說明

      選擇調度該任務的專屬叢集

      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

      說明

      若目標表是用HBase建立的,請注意如下事項:

      • ETL的文法包括需要配置的列和需要排除的列,在遷移過程中會將MongoDB已配置ETL的文檔(Document)所有頂層欄位,儲存在HBase表預設的列族f中。以下樣本表示:將除_idname兩個頂層元素的其他元素作為動態列寫入目標表。更多資訊,請參見HBase表遷移樣本(ETL)

        script:e_expand_bson_value("*", "_id,name")
      • 若您需要同時使用新增列和ETL功能,請確保Lindorm中的資料不會重複。

      • 新增列和ETL功能均未配置的列不會遷移至目標庫。

      監控警示

      是否設定警示,當遷移失敗或延遲超過閾值後,將通知警示連絡人。

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

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

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

    說明
    • 在遷移任務正式啟動之前,會先進行預檢查。只有預檢查通過後,才能成功啟動遷移任務。

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

    • 如果預檢查產生警告:

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

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

  8. 購買執行個體。

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

    2. 購買頁面,選擇資料移轉執行個體的鏈路規格,詳細說明請參見下表。

      類別

      參數

      說明

      資訊配置

      資源群組配置

      選擇執行個體所屬的資源群組,預設為default resource group。更多資訊,請參見什麼是資源管理

      鏈路規格

      DTS為您提供了不同效能的遷移規格,遷移鏈路規格的不同會影響遷移速率,您可以根據業務情境進行選擇。更多資訊,請參見資料移轉鏈路規格說明

    3. 配置完成後,閱讀並選中《資料轉送(隨用隨付)服務條款》

    4. 單擊購買並啟動,並在彈出的確認對話方塊,單擊確定

      您可在資料移轉介面查看具體進度。

HBase表添加列映射樣本

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

說明

Lindorm須為2.4.0及以上版本。

  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表結構

列名稱

類型

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")