全部產品
Search
文件中心

Data Transmission Service:ApsaraDB for MongoDB(複本集架構)同步至ApsaraDB for MongoDB(複本集架構或分區叢集架構)

更新時間:Jan 03, 2025

Data Transmission Service支援將MongoDB資料庫(複本集架構)同步至MongoDB資料庫(複本集架構或分區叢集架構)。

支援的源和目標資料庫

MongoDB版(複本集架構)同步至MongoDB版(複本集架構、分區叢集架構),支援以下源或目標資料庫。本文以ApsaraDB for MongoDB(複本集架構)、ApsaraDB for MongoDB(複本集架構、分區叢集架構)為目標資料庫介紹配置流程,其他資料來源配置流程與本案例類似。

來源資料庫

目標資料庫

ApsaraDB for MongoDB(複本集架構)

ApsaraDB for MongoDB(複本集架構、分區叢集架構)

ECS上的自建MongoDB資料庫(複本集架構)

ECS上的自建MongoDB資料庫(複本集架構、分區叢集架構)

通過專線、VPN網關或智能網關接入的自建MongoDB資料庫(複本集架構)

通過專線、VPN網關或智能網關接入的自建MongoDB資料庫(複本集架構、分區叢集架構)

前提條件

注意事項

類型

說明

源庫限制

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

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

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

  • 源庫待同步的單條資料不能超過16 MB,否則會導致任務失敗。

  • 源庫不支援Azure Cosmos DB for MongoDB和彈性叢集的Amazon DocumentDB。

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

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

    • 僅4.0及以上版本的MongoDB支援通過Change Streams擷取資料變更,使用Change Streams擷取源庫的資料變更不支援雙向同步。

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

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

  • 源庫操作限制:

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

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

其他限制

  • 目標端執行個體為分區叢集架構時:

    • 需清除孤立文檔,否則將影響同步效能。若在同步過程遇到_id衝突的文檔,則可能導致資料不一致或任務失敗。

    • 在任務開始前,需要為源端待同步的資料添加與目標端對應的分區鍵。若您無法為源端添加分區鍵,源MongoDB資料庫的同步操作,請參見MongoDB(無分區鍵)同步至MongoDB(分區叢集架構)

    • 在任務開始後,待同步的資料在使用INSERT命令時必須包含分區鍵,使用UPDATE命令時不支援更改分區鍵。

  • 建議源和目標庫的MongoDB的資料庫版本保持一致,或者從低版本同步到高版本以保障相容性。如為高版本同步至低版本,可能存在資料庫相容性問題。

  • 不支援同步admin和local庫中的資料。

  • 若目的地組合存在唯一索引或目的地組合的capped屬性為true時,則在增量同步處理階段該集合不支援並發回放(只支援單線程寫入),從而可能會導致任務延遲增高。

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

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

  • 全量初始化會並發執行INSERT操作,導致目標資料庫的集合產生片段,因此全量初始化完成後目標執行個體的集合空間比源執行個體的集合空間大。

  • 在DTS同步期間,不允許有除DTS外的資料寫入目標庫,否則會導致源庫與目標庫資料不一致。例如,有除DTS外的資料寫入目標庫時,使用DMS執行線上DDL變更,可能引起目標庫資料丟失。

  • 由於DTS寫入資料的邏輯為並發寫入,所以會導致目標端佔用的儲存空間比源端大5%~10%。

  • 目標端MongoDB的count數量需要使用db.$table_name.aggregate([{ $count:"myCount"}])文法查詢。

  • 請確保目標端MongoDB沒有與源端相同的主鍵(預設為_id),否則會導致資料丟失。若目標端有與源端相同的主鍵,請在不影響業務的前提條件下清空目標端的相關資料(刪掉目標端中與源端相同_id的文檔)。

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

    說明

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

特殊情況

當源庫為自建MongoDB時:

  • 在同步時,如果源庫進行主備切換,將會導致同步任務失敗。

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

說明

如果同步對象選擇為整庫,您還可以建立心跳錶,心跳錶每秒定期更新或者寫入資料。

費用說明

同步類型

鏈路配置費用

庫表結構同步和全量資料同步

不收費。

增量資料同步

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

支援的同步架構

  • 一對一單向同步

  • 一對多單向同步

  • 多對一單向同步

  • 級聯單向同步

關於各類同步架構的介紹及注意事項,請參見資料同步拓撲介紹

任務步驟說明

同步類型

說明

庫表結構同步

將源ApsaraDB for MongoDB中同步對象的結構同步到目標ApsaraDB for MongoDB中。

全量同步

將源ApsaraDB for MongoDB同步對象的存量資料全部同步到目標ApsaraDB for MongoDB中。

說明

支援全量同步DATABASE和COLLECTION。

增量同步處理

在全量同步的基礎上,將源ApsaraDB for MongoDB的累加式更新同步到目標ApsaraDB for MongoDB中。

使用Oplog

增量同步處理不支援在任務開始運行後建立的資料庫,支援同步的累加式更新如下:

  • CREATE COLLECTION、INDEX

  • DROP DATABASE、COLLECTION、INDEX

  • RENAME COLLECTION

  • 在集合中插入、更新、刪除文檔的操作。

    說明

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

使用ChangeStream

支援同步的累加式更新如下:

  • DROP DATABASE、COLLECTION

  • RENAME COLLECTION

  • 在集合中插入、更新、刪除文檔的操作。

    說明

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

操作步驟

  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所屬地區。

    是否跨阿里雲帳號

    本樣本使用當前阿里雲帳號下的資料庫執行個體,需選擇不跨帳號

    架構類型

    選擇複本集架構

    遷移方式

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

    • 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的資料庫帳號,需具備待同步庫、config庫、admin庫和local庫的read許可權。

    資料庫密碼

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

    串連方式

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

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

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

    目標庫資訊

    選擇已有串連資訊

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

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

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

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

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

    資料庫類型

    選擇MongoDB

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇目標ApsaraDB for MongoDB所屬地區。

    是否跨阿里雲帳號

    本樣本使用當前阿里雲帳號下的資料庫執行個體,需選擇不跨帳號

    架構類型

    選擇目標ApsaraDB for MongoDB所屬的架構類型。

    執行個體ID

    選擇目標ApsaraDB for MongoDB執行個體ID。

    鑒權資料庫名稱

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

    資料庫帳號

    填入目標ApsaraDB for MongoDB的資料庫帳號,需具備dbAdminAnyDatabase許可權、目標庫的readWrite許可權和local庫的read許可權。

    資料庫密碼

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

    串連方式

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

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

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

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

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

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

  6. 配置任務對象。

    1. 對象配置頁面,配置待同步的對象。

      配置

      說明

      同步類型

      固定選中增量同步處理。預設情況下,您還需要同時選中庫表結構同步全量同步。預檢查完成後,DTS會將源執行個體中待同步對象的全量資料在目的地組群中初始化,作為後續增量同步處理資料的基準資料。

      說明

      更多資訊,請參見任務步驟說明

      目標已存在表的處理模式

      • 預檢查並報錯攔截:檢查目標資料庫中是否有同名的集合。如果目標資料庫中沒有同名的集合,則通過該檢查專案;如果目標資料庫中有同名的集合,則在預檢查階段提示錯誤,資料同步任務不會被啟動。

        說明

        如果目標庫中同名的集合不方便刪除或重新命名,您可以更改該集合在目標庫中的名稱,詳情請參見設定同步對象在目標執行個體中的名稱

      • 忽略報錯並繼續執行:跳過目標資料庫中是否有同名集合的檢查項。

        警告

        選擇為忽略報錯並繼續執行,可能導致資料不一致,給業務帶來風險,例如:

        • 在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄,則會保留目標庫中的該條記錄,即源庫中的該條記錄不會同步至目標庫中。

        • 可能會導致無法初始化資料、只能同步部分的資料或同步失敗。

      同步拓撲

      請選擇單向同步

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

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

      源庫對象

      源庫對象框中單擊待同步對象,然後單擊向右將其移動至已選擇對象框。

      說明

      同步對象的選擇粒度為DATABASE、COLLECTION。

      已選擇對象

      • 如需更改同步對象在目標執行個體中的名稱,請右擊已選擇對象中的同步對象進行修改。設定方式,請參見庫表列名映射

      • 如需移除已選擇的同步對象,請在已選擇對象框中單擊待同步的對象,然後單擊image將其移動到源庫對象框。

      說明
      • 如需按庫或集合層級選擇增量同步處理的操作,請在已選擇對象中右擊待同步的對象,並在彈出的對話方塊中進行選擇。

      • 如需設定條件過濾資料(全量同步階段支援條件過濾資料,增量同步處理階段不支援),請在已選擇對象中右擊待同步的表,並在彈出的對話方塊中進行設定。設定方法,請參見設定過濾條件

      • 如果使用了對象名映射功能(指定用於接收資料的資料庫或集合),可能會導致依賴這個對象的其他對象同步失敗。

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

      配置

      說明

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

      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

      監控警示

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

    3. 單擊下一步資料校正,進行資料校正任務配置。

      若您需要使用資料校正功能,配置方法請參見配置資料校正

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

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

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

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

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

    • 如果預檢查產生警告:

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

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

  8. 購買執行個體。

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

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

      類別

      參數

      說明

      資訊配置

      計費方式

      • 預付費(訂用帳戶):在建立執行個體時支付費用。適合長期需求,價格比隨用隨付更實惠,且購買時間長度越長,折扣越多。

      • 後付費(隨用隨付):按小時計費。適合短期需求,用完可立即釋放執行個體,節省費用。

      資源群組配置

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

      鏈路規格

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

      訂購時間長度

      在預付費模式下,選擇訂用帳戶執行個體的時間長度和數量,包月可選擇1~9個月,包年可選擇1年、2年、3年和5年。

      說明

      該選項僅在付費類型為預付費時出現。

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

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

      您可在資料同步介面查看具體任務進度。