本文中含有需要您注意的重要提示信息，忽略該信息可能對您的業務造成影響，請務必仔細閱讀。
數據傳輸服務DTS（Data Transmission Service）支持在源端MongoDB的數據中分片鍵字段缺失的情況下，將數據同步至分片集群架構的MongoDB中，并指定分片鍵的默認值。本文以云數據庫MongoDB版（副本集架構）為源且云數據庫MongoDB版（分片集群架構）為目標，為您介紹同步操作的步驟。
前提條件
已創建目標云數據庫MongoDB版（分片集群架構）。創建方式，請參見創建分片集群實例。
說明源為分片集群架構的云數據庫MongoDB版，則需為Shard節點申請連接地址，且各Shard的賬號和密碼需保持一致。申請方法，請參見申請Shard或ConfigServer節點連接地址。
支持的版本，請參見同步方案概覽。
目標云數據庫MongoDB版的存儲空間比源云數據庫MongoDB版占用的存儲空間大，建議目標端比源端的存儲空間大10%。
根據業務需要，在目標云數據庫MongoDB版中創建需要分片的數據庫和集合、配置數據分片、開啟Balancer并進行預分片。更多信息，請參見設置數據分片以充分利用Shard性能和如何處理分片集群架構的MongoDB數據分布不均衡。
說明配置數據分片可避免數據被同步至同一Shard，導致無法發揮集群性能；開啟Balancer并進行預分片可以避免數據傾斜問題。
注意事項
類型 | 說明 |
源庫限制 |
|
其他限制 |
|
特殊情況 | 當源庫為自建MongoDB時：
說明 如果同步對象選擇為整庫，您還可以創建心跳，心跳每秒定期更新或者寫入數據。 |
費用說明
| 同步類型 | 鏈路配置費用 |
| 庫表結構同步和全量數據同步 | 不收費。 |
| 增量數據同步 | 收費，詳情請參見計費概述。 |
任務步驟說明
同步類型 | 說明 |
庫表結構同步 | 將源云數據庫MongoDB版中同步對象的結構同步到目標云數據庫MongoDB版中。 |
全量同步 | 將源云數據庫MongoDB版同步對象的存量數據全部同步到目標云數據庫MongoDB版中。 說明 支持全量同步DATABASE和COLLECTION。 |
增量同步 | 在全量同步的基礎上，將源云數據庫MongoDB版的增量更新同步到目標云數據庫MongoDB版中。 說明 不支持增量同步在任務開始運行后新建的數據庫，支持同步的增量更新如下：
|
數據庫賬號的權限要求
數據庫 | 所需權限 | 創建及授權方式 |
源云數據庫MongoDB版 | 待同步庫、admin庫和local庫的read權限。 | |
目標云數據庫MongoDB版 | dbAdminAnyDatabase權限、目標庫的readWrite權限、local庫的read權限和config庫的read權限。 |
操作步驟
進入同步任務的列表頁面。
登錄DMS數據管理服務。
在頂部菜單欄中，單擊集成與開發（DTS）。
在左側導航欄，選擇。
說明實際操作可能會因DMS的模式和布局不同，而有所差異。更多信息。請參見極簡模式控制臺和自定義DMS界面布局與樣式。
您也可以登錄新版DTS同步任務的列表頁面。
在同步任務右側，選擇同步實例所屬地域。
說明新版DTS同步任務列表頁面，需要在頁面左上角選擇同步實例所屬地域。
單擊創建任務，配置源庫及目標庫信息。
類別
配置
說明
無
任務名稱
DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
源庫信息
選擇已有的DMS數據庫實例（可選，如未創建可忽略此處選擇，直接在下方配置數據庫信息即可）
您可以按實際需求，選擇是否使用已有實例。
如使用已有實例，下方數據庫信息將自動填入，您無需重復輸入。
如不使用已有實例，您需要輸入下方的數據庫信息。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇源云數據庫MongoDB版實例所屬地域。
是否跨阿里云賬號
本示例為同一阿里云賬號間的同步，選擇不跨賬號。
架構類型
本示例選擇副本集架構。
實例ID
選擇源云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入源云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱，若未修改過則為默認的admin。
數據庫賬號
填入源云數據庫MongoDB版實例的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
目標庫信息
選擇已有的DMS數據庫實例（可選，如未創建可忽略此處選擇，直接在下方配置數據庫信息即可）
您可以按實際需求，選擇是否使用已有實例。
如使用已有實例，下方數據庫信息將自動填入，您無需重復輸入。
如不使用已有實例，您需要輸入下方的數據庫信息。
數據庫類型
選擇MongoDB。
接入方式
選擇云實例。
實例地區
選擇目標云數據庫MongoDB版實例所屬地域。
架構類型
本示例需選擇為分片集群架構。
實例ID
選擇目標云數據庫MongoDB版實例ID。
鑒權數據庫名稱
填入目標云數據庫MongoDB版實例數據庫賬號所屬的數據庫名稱，若未修改過則為默認的admin。
數據庫賬號
填入目標云數據庫MongoDB版的數據庫賬號，權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
配置完成后，單擊頁面下方的測試連接以進行下一步。
如果源或目標數據庫是阿里云數據庫實例（例如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會將源實例中待同步對象的全量數據在目標集群中初始化，作為后續增量同步數據的基線數據。
目標已存在表的處理模式
預檢查并報錯攔截：檢查目標數據庫中是否有同名的集合。如果目標數據庫中沒有同名的集合，則通過該檢查項目；如果目標數據庫中有同名的集合，則在預檢查階段提示錯誤，數據同步任務不會被啟動。
說明如果目標庫中同名的集合不方便刪除或重命名，您可以更改該集合在目標庫中的名稱，詳情請參見設置同步對象在目標實例中的名稱。
忽略報錯并繼續執行：跳過目標數據庫中是否有同名集合的檢查項。
警告選擇為忽略報錯并繼續執行，可能導致數據不一致，給業務帶來風險，例如：
在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄，則會保留目標庫中的該條記錄，即源庫中的該條記錄不會同步至目標庫中。
可能會導致無法初始化數據、只能同步部分的數據或同步失敗。
同步拓撲
選擇單向同步。
目標庫對象名稱大小寫策略
您可以配置目標實例中同步對象的庫名、表名和列名的英文大小寫策略。默認情況下選擇DTS默認策略，您也可以選擇與源庫、目標庫默認策略保持一致。更多信息，請參見目標庫對象名稱大小寫策略。
源庫對象
在源庫對象框中單擊待同步對象，然后單擊
將其移動至已選擇對象框。說明同步對象的選擇粒度為庫或集合。
已選擇對象
如需指定目標MongoDB（分片集群架構）中用于接收數據的數據庫名稱：
右鍵單擊已選擇對象下方的目標數據庫，在彈出的編輯Schema對話框中，將Schema名稱修改為目標MongoDB（分片集群架構）中用于接收數據的數據庫名稱。更多信息，請參見庫表列名單個映射。
如需指定目標MongoDB（分片集群架構）中用于接收數據的集合名稱：
右鍵單擊已選擇對象下方的集合，在彈出的編輯表對話框中，將表名稱修改為目標MongoDB（分片集群架構）中用于接收數據的集合名稱。
重要僅當同步對象的粒度為集合時，支持指定用于接收數據的集合。
說明若您需設置條件過濾數據（全量同步階段支持條件過濾數據，增量同步階段不支持條件數據過濾），請在已選擇對象中右擊待同步的表，在彈出的對話框中設置過濾條件。設置方法請參見設置過濾條件。
如果使用了對象名映射功能（指定用于接收數據的庫數據庫或集合），可能會導致依賴這個對象的其他對象同步失敗。
單擊下一步高級配置，進行高級配置。
數據校驗配置
若您需要配置數據校驗，請參見配置數據校驗。
高級配置
配置
說明
選擇調度該任務的專屬集群
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功能。
單擊下一步配置庫表字段，設置ShardKey的默認值。
單擊目標集合行列的設置默認值。
說明ShardKey數量為0的表名稱（集合），表示目標集合中沒有分片鍵，無需設置默認值。
選擇ShardKey默認值類型。
說明當前ShardKey默認值類型僅支持string和int。
設置ShardKey的默認值。
重要僅當目標MongoDB（分片集群架構）的版本低于4.4時，設置的ShardKey默認值才會生效。
您需要為待同步對象中所有的ShardKey設置默認值，否則預檢查階段將會產生告警，甚至會導致任務運行失敗。
保存任務并進行預檢查。
若您需要查看調用API接口配置該實例時的參數信息，請將鼠標光標移動至下一步保存任務并預檢查按鈕上，然后單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數，請單擊頁面下方的下一步保存任務并預檢查。
說明在同步作業正式啟動之前，會先進行預檢查。只有預檢查通過后，才能成功啟動同步作業。
如果預檢查失敗，請單擊失敗檢查項后的查看詳情，并根據提示修復后重新進行預檢查。
如果預檢查產生警告：
對于不可以忽略的檢查項，請單擊失敗檢查項后的查看詳情，并根據提示修復后重新進行預檢查。
對于可以忽略無需修復的檢查項，您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查，跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項，可能會導致數據不一致等問題，給業務帶來風險。
預檢查通過率顯示為100%時，單擊下一步購買。
在購買頁面，選擇數據同步實例的計費方式、鏈路規格，詳細說明請參見下表。
類別
參數
說明
信息配置
計費方式
預付費（包年包月）：在新建實例時支付費用。適合長期需求，價格比按量付費更實惠，且購買時長越長，折扣越多。
后付費（按量付費）：按小時扣費。適合短期需求，用完可立即釋放實例，節省費用。
資源組配置
實例所屬的資源組，默認為default resource group。更多信息，請參見什么是資源管理。
鏈路規格
DTS為您提供了不同性能的同步規格，同步鏈路規格的不同會影響同步速率，您可以根據業務場景進行選擇。更多信息，請參見數據同步鏈路規格說明。
訂購時長
在預付費模式下，選擇包年包月實例的時長和數量，包月可選擇1~9個月，包年可選擇1年、2年、3年和5年。
說明該選項僅在付費類型為預付費時出現。
配置完成后，閱讀并勾選《數據傳輸（按量付費）服務條款》。
單擊購買并啟動，同步任務正式開始，您可在數據同步界面查看具體任務進度。