本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
數據傳輸服務DTS（Data Transmission Service）支持云數據庫MongoDB版（分片集群架構）間的雙向同步，適用于異地多活（單元化）、數據異地容災等多種應用場景。本文介紹雙向數據同步的配置步驟。
前提條件
已創建源和目標云數據庫MongoDB版分片集群實例，創建方式，請參見創建分片集群實例。
重要源云數據庫MongoDB版分片集群實例的Shard節點需要申請連接地址，且各Shard的賬號和密碼需保持一致。申請方法，請參見申請Shard或ConfigServer節點連接地址。
支持的版本，請參見同步方案概覽。
建議目標云數據庫MongoDB版實例的存儲空間比源云數據庫MongoDB版實例占用的存儲空間大10%。
您需要將源和目標實例的Shard和ConfigServer節點參數replication.oplogGlobalIdEnabled設置為true，設置方式，請參見設置數據庫參數。
說明若未設置為true，將會導致實例預檢查失敗或者報錯
two-way mongo must have gid。您需要根據業務需求，在源和目標云數據庫MongoDB版實例中創建需要分片的數據庫和集合、配置數據分片、開啟Balancer（源云數據庫MongoDB版實例必須在增量同步期間開啟Balancer）并進行預分片。更多信息，請參見設置數據分片以充分利用Shard性能和如何處理分片集群架構的MongoDB數據分布不均衡。
說明配置數據分片可避免數據被同步至同一Shard，導致無法發揮集群性能；開啟Balancer并進行預分片可以避免數據傾斜問題。
本配置場景以先配置后購買DTS任務為例，無需填寫源云數據庫MongoDB版（分片集群架構）下的Shard數量。
如您先購買后配置DTS任務，則需要在購買DTS任務時填寫其正確的Shard數量。
注意事項
類型 | 說明 |
源和目標庫的限制 |
|
其他限制 |
|
費用說明
| 同步類型 | 鏈路配置費用 |
| 庫表結構同步和全量數據同步 | 不收費。 |
| 增量數據同步 | 收費，詳情請參見計費概述。 |
支持的雙向同步架構
目前DTS僅支持兩個云數據庫MongoDB版實例（分片集群架構）之間的雙向同步，暫不支持多個云數據庫MongoDB版實例之間的雙向同步。
支持的沖突檢測
為保障同步數據的一致性，您需要確保同一個主鍵、業務主鍵或唯一鍵的記錄只在雙向同步的一個節點進行更新。如果同時更新則會按照您在數據同步作業中配置的沖突修復策略進行響應。
DTS通過沖突檢測和修復最大程度地維護雙向同步實例的穩定性。目前DTS支持進行檢測的沖突類型包括：
INSERT導致的唯一性沖突
同步INSERT語句時違背了唯一性約束，例如雙向同步的兩個節點同時或者在極為接近的時間INSERT某個主鍵值相同的記錄，那么同步到對端時，會因為已經存在相同主鍵值的記錄，導致Insert同步失敗。
UPDATE更新的記錄不完全匹配
UPDATE要更新的記錄在同步目標實例中不存在時，DTS會自動轉化為INSERT，此時可能會出現唯一鍵的唯一性沖突。
UPDATE要更新的記錄出現主鍵或唯一鍵沖突。
DELETE對應的記錄不存在
DELETE要刪除的記錄在同步的目標實例中不存在。出現這種沖突時，不論配置何種沖突修復策略，DTS都會自動忽略DELETE操作。
由于數據同步兩端的系統時間可能存在差異、同步存在延時等多種因素，DTS無法完全保證沖突檢測機制能夠完全防止數據的沖突。在使用雙向同步時，您需要在業務層面配合進行相應的改造，保證同一個主鍵、業務主鍵或唯一鍵的記錄只在雙向同步的某個節點進行更新。
對于上述數據同步的沖突，DTS提供了修復策略，您可以在配置雙向同步時選擇。
任務步驟說明
同步類型 | 說明 |
庫表結構同步 | 將源云數據庫MongoDB版中同步對象的結構同步到目標云數據庫MongoDB版中。 |
全量同步 | 將源云數據庫MongoDB版同步對象的存量數據全部同步到目標云數據庫MongoDB版中。 說明 支持全量同步DATABASE和COLLECTION。 |
增量同步 | 在全量同步的基礎上，將源云數據庫MongoDB版的增量更新同步到目標云數據庫MongoDB版中。 說明 支持同步的增量更新如下：
|
操作步驟
本配置場景以先配置后購買DTS任務為例，無需填寫源云數據庫MongoDB版（分片集群架構）下的Shard數量。
如您先購買后配置DTS任務，則需要在購買DTS任務時填寫其正確的Shard數量。
- 說明
您也可以登錄DMS數據管理服務。在頂部菜單欄中，選擇集成與開發（DTS），在左側導航欄選擇。
在頁面左上角，選擇同步實例所屬地域。
單擊創建任務，配置源庫及目標庫信息。
警告選擇源和目標實例后，建議您仔細閱讀頁面上方顯示的使用限制，否則可能會導致任務失敗或數據不一致。
類別
配置
說明
無
任務名稱
DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
源庫信息
選擇已有的DMS數據庫實例（可選，如未創建可忽略此處選擇，直接在下方配置數據庫信息即可）
您可以按實際需求，選擇是否使用已有實例。
如使用已有實例，下方數據庫信息將自動填入，您無需重復輸入。
如不使用已有實例，您需要輸入下方的數據庫信息。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇源云數據庫MongoDB版所屬地域。
是否跨阿里云賬號
本示例為同一阿里云賬號間的同步，選擇不跨賬號。
架構類型
選擇分片集群架構。
實例ID
選擇源云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入源云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱，若未修改過則默認為admin。
數據庫賬號
填入源云數據庫MongoDB版的數據庫賬號，需具備待同步庫、admin庫和local庫的read權限。
數據庫密碼
填入該數據庫賬號對應的密碼。
shard賬號
填入源云數據庫MongoDB版的數據庫Shard賬號。
shard密碼
填入源云數據庫MongoDB版的數據庫Shard密碼。
目標庫信息
選擇已有的DMS數據庫實例（可選，如未創建可忽略此處選擇，直接在下方配置數據庫信息即可）
您可以按實際需求，選擇是否使用已有實例。
如使用已有實例，下方數據庫信息將自動填入，您無需重復輸入。
如不使用已有實例，您需要輸入下方的數據庫信息。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇目標云數據庫MongoDB版所屬地域。
架構類型
選擇分片集群架構。
實例ID
選擇目標云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入目標云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱，若未修改過則默認為admin。
數據庫賬號
填入目標云數據庫MongoDB版的數據庫賬號，需具備dbAdminAnyDatabase權限、目標庫的readWrite權限和local庫的read權限。
數據庫密碼
填入該數據庫賬號對應的密碼。
配置完成后，單擊頁面下方的測試連接以進行下一步。
如果源或目標數據庫是阿里云數據庫實例（例如RDS MySQL、云數據庫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網關/智能網關）的方式接入。
配置任務對象及高級配置。
配置
說明
同步類型
固定選中增量同步。默認情況下，您還需要同時選中庫表結構同步和全量同步。預檢查完成后，DTS會將源實例中待同步對象的全量數據在目標集群中初始化，作為后續增量同步數據的基線數據。
目標已存在表的處理模式
預檢查并報錯攔截：檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合，則通過該檢查項目；如果目標數據庫中有同名的集合，則在預檢查階段提示錯誤，數據同步任務不會被啟動。
說明如果目標庫中同名的集合不方便刪除或重命名，您可以更改該集合在目標庫中的名稱，詳情請參見設置同步對象在目標實例中的名稱。
忽略報錯并繼續執行：跳過目標數據庫中是否有同名集合的檢查項。
警告選擇為忽略報錯并繼續執行，可能導致數據不一致，給業務帶來風險，例如：
在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄，則會保留目標庫中的該條記錄，即源庫中的該條記錄不會同步至目標庫中。
可能會導致無法初始化數據、只能同步部分的數據或同步失敗。
同步拓撲
請選擇雙向同步。
是否過濾DDL
選擇為是：不同步DDL操作。
選擇為否：同步DDL操作。
說明DDL語法同步方向限制 。為保障雙向同步鏈路的穩定性，只支持正向同步任務同步DDL，不支持反向同步任務同步DDL。
沖突修復策略
如遇到以上支持的沖突檢測，根據業務需要，選擇合適的沖突修復策略。
TaskFailed（遇到沖突，任務報錯退出）
當數據同步遇到沖突時，同步任務直接報錯并退出，同步任務進入失敗狀態，需要您介入修復任務。
Ignore（遇到沖突，直接使用目標實例中的沖突記錄）
當數據同步遇到沖突時，直接跳過當前同步語句，繼續往下執行，選擇使用目標庫中的沖突記錄。
Overwrite（遇到沖突，直接覆蓋目標實例中的沖突記錄）
當數據同步遇到沖突時，直接覆蓋目標庫中的沖突記錄。
說明本場景僅支持Ignore。
源庫對象
在源庫對象框中單擊待同步對象，然后單擊
將其移動至已選擇對象框。說明同步對象的選擇粒度為DATABASE、COLLECTION。
已選擇對象
如需更改單個同步對象在目標實例中的名稱，請右擊已選擇對象中的同步對象，設置方式，請參見庫表列名單個映射。
如需批量更改同步對象在目標實例中的名稱，請單擊已選擇對象方框右上方的批量編輯，設置方式，請參見庫表列名批量映射。
說明若您需設置條件過濾數據（全量同步階段支持條件過濾數據，增量同步階段不支持條件數據過濾），請在已選擇對象中右擊待同步的表，在彈出的對話框中設置過濾條件。設置方法請參見設置過濾條件。
如果使用了對象名映射功能（指定用于接收數據的庫數據庫或集合），可能會導致依賴這個對象的其他對象同步失敗。
單擊下一步高級配置，進行高級配置。
數據校驗配置
若您需要配置數據校驗，請參見配置數據校驗。
高級配置
配置
說明
選擇調度該任務的專屬集群
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功能。
保存任務并進行預檢查。
若您需要查看調用API接口配置該實例時的參數信息，請將鼠標光標移動至下一步保存任務并預檢查按鈕上，然后單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數，請單擊頁面下方的下一步保存任務并預檢查。
說明在同步作業正式啟動之前，會先進行預檢查。只有預檢查通過后，才能成功啟動同步作業。
如果預檢查失敗，請單擊失敗檢查項后的查看詳情，并根據提示修復后重新進行預檢查。
如果預檢查產生警告：
對于不可以忽略的檢查項，請單擊失敗檢查項后的查看詳情，并根據提示修復后重新進行預檢查。
對于可以忽略無需修復的檢查項，您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查，跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項，可能會導致數據不一致等問題，給業務帶來風險。
預檢查通過率顯示為100%時，單擊下一步購買。
在購買頁面，選擇數據同步實例的計費方式、鏈路規格，詳細說明請參見下表。
類別
參數
說明
信息配置
計費方式
預付費（包年包月）：在新建實例時支付費用。適合長期需求，價格比按量付費更實惠，且購買時長越長，折扣越多。
后付費（按量付費）：按小時扣費。適合短期需求，用完可立即釋放實例，節省費用。
資源組配置
實例所屬的資源組，默認為default resource group。更多信息，請參見什么是資源管理。
鏈路規格
DTS為您提供了不同性能的同步規格，同步鏈路規格的不同會影響同步速率，您可以根據業務場景進行選擇。更多信息，請參見數據同步鏈路規格說明。
訂購時長
在預付費模式下，選擇包年包月實例的時長和數量，包月可選擇1~9個月，包年可選擇1年、2年、3年和5年。
說明該選項僅在付費類型為預付費時出現。
配置完成后，閱讀并勾選《數據傳輸（按量付費）服務條款》。
單擊購買并啟動，正向同步任務正式開始，您可在任務列表查看具體任務進度。
等待正向同步任務狀態處于運行中，定位至反向同步任務，并單擊配置任務。
- 重要
配置反向任務時，您需要選擇正確的源和目標實例。反向同步中源實例為正向同步中的目標實例，目標實例為正向同步中的源實例，并且您還需仔細確認實例信息（如數據庫名稱、賬號、密碼）的一致性。
配置反向任務時不建議更改映射名稱，否則可能會導致數據不一致。
反向同步任務源和目標庫的實例地區不支持修改，且需要配置的參數比正向同步任務少，請以控制臺界面為準。
反向同步任務的目標已存在表的處理模式配置不檢測正向同步任務同步至目標實例中的表。
反向同步任務不支持同步正向任務已選擇對象中的對象。
反向同步任務將自動過濾DDL操作。
預檢查通過率顯示為100%時，單擊返回列表。
第二個同步任務配置完成后，等待兩個同步任務鏈路的運行狀態均處于運行中，即完成雙向數據同步的配置流程。