前提條件

• 若源庫為分片集群架構(gòu)的云數(shù)據(jù)庫MongoDB版，則還需為所有Shard節(jié)點申請連接地址，且各Shard的賬號和密碼需保持一致。申請方法，請參見申請Shard或ConfigServer節(jié)點連接地址。

• 已創(chuàng)建存儲空間大于源云數(shù)據(jù)庫MongoDB版實例已占用存儲空間的目標(biāo)RDS MySQL實例。創(chuàng)建方法，請參見創(chuàng)建RDS MySQL實例。

  說明

  建議目標(biāo)實例的存儲空間比源數(shù)據(jù)庫已使用的存儲空間大10%。

• 已在目標(biāo)RDS MySQL實例中創(chuàng)建用于接收數(shù)據(jù)的數(shù)據(jù)庫、具有主鍵的表。更多信息，請參見管理數(shù)據(jù)庫。

  重要

  • 請務(wù)必確保目標(biāo)表的數(shù)據(jù)類型與源MongoDB的數(shù)據(jù)兼容。例如，若MongoDB中的_id為ObjectId類型，則對應(yīng)RDS MySQL實例中數(shù)據(jù)類型需為varchar。

  • RDS MySQL實例中目標(biāo)表的列名不能為_id和_value。

注意事項

費用說明

同步類型說明

數(shù)據(jù)庫賬號的權(quán)限要求

操作步驟

1. 進入目標(biāo)地域的同步任務(wù)列表頁面（二選一）。

   通過DTS控制臺進入

   1. 登錄數(shù)據(jù)傳輸服務(wù)DTS控制臺。

   2. 在左側(cè)導(dǎo)航欄，單擊數(shù)據(jù)同步。

   3. 在頁面左上角，選擇同步實例所屬地域。

   通過DMS控制臺進入

   說明

   實際操作可能會因DMS的模式和布局不同，而有所差異。更多信息，請參見極簡模式控制臺和自定義DMS界面布局與樣式。

   1. 登錄DMS數(shù)據(jù)管理服務(wù)。

   2. 在頂部菜單欄中，選擇集成與開發(fā) > 數(shù)據(jù)傳輸（DTS） > 數(shù)據(jù)同步。

   3. 在同步任務(wù)右側(cè)，選擇同步實例所屬地域。

2. 單擊創(chuàng)建任務(wù)，進入任務(wù)配置頁面。

3. 可選：在頁面右上角，單擊試用新版配置頁。

   說明

   • 若您已進入新版配置頁（頁面右上角的按鈕為返回舊版配置頁），則無需執(zhí)行此操作。

   • 新版配置頁和舊版配置頁部分參數(shù)有差異，建議使用新版配置頁。

4. 配置源庫及目標(biāo)庫信息。

   類別	配置	說明
   無	任務(wù)名稱	DTS會自動生成一個任務(wù)名稱，建議配置具有業(yè)務(wù)意義的名稱（無唯一性要求），便于后續(xù)識別。
   源庫信息	選擇已有連接信息	您可以按實際需求，選擇是否使用已有數(shù)據(jù)庫實例。 如使用已有實例，下方數(shù)據(jù)庫信息將自動填入，您無需重復(fù)輸入。 如不使用已有實例，您需要配置下方的數(shù)據(jù)庫信息。 說明 您可以在數(shù)據(jù)連接管理頁面或新版配置頁面，將數(shù)據(jù)庫錄入DTS。更多信息，請參見數(shù)據(jù)連接管理。 DMS控制臺的配置項為選擇DMS數(shù)據(jù)庫實例，您可以單擊新增DMS數(shù)據(jù)庫實例或在控制臺首頁將數(shù)據(jù)庫錄入DMS。更多信息，請參見云數(shù)據(jù)庫錄入和他云/自建數(shù)據(jù)庫錄入。
   	數(shù)據(jù)庫類型	選擇MongoDB。
   	接入方式	選擇云實例。
   	實例地區(qū)	選擇源云數(shù)據(jù)庫MongoDB版所屬的地域。
   	是否跨阿里云賬號	本示例使用當(dāng)前阿里云賬號下的數(shù)據(jù)庫實例，需選擇不跨賬號。
   	架構(gòu)類型	本示例選擇副本集架構(gòu)。 說明 若您的源云數(shù)據(jù)庫MongoDB版為分片集群架構(gòu)，您還需要填寫Shard賬號和Shard密碼。
   	遷移方式	請根據(jù)實際情況，選擇增量數(shù)據(jù)同步的方式。 Oplog（推薦）： 若源庫已開啟Oplog日志，則支持此選項。 說明 本地自建MongoDB和云數(shù)據(jù)庫MongoDB版默認(rèn)已開啟Oplog日志，且使用此方式同步增量數(shù)據(jù)時增量同步任務(wù)的延遲較小（拉取日志的速度較快），因此推薦選擇Oplog。 ChangeStream： 若源庫已開啟變更流（Change Streams），則支持此選項。 說明 源庫為Amazon DocumentDB（非彈性集群）時，僅支持選擇ChangeStream。 源庫架構(gòu)類型選擇為分片集群架構(gòu)，無需填寫Shard賬號和Shard密碼。
   	實例ID	選擇源云數(shù)據(jù)庫MongoDB版的實例ID。
   	鑒權(quán)數(shù)據(jù)庫名稱	填入源云數(shù)據(jù)庫MongoDB版實例中數(shù)據(jù)庫賬號所屬的數(shù)據(jù)庫名稱，若未修改過則為默認(rèn)的admin。
   	數(shù)據(jù)庫賬號	填入源云數(shù)據(jù)庫MongoDB版的數(shù)據(jù)庫賬號。權(quán)限要求，請參見數(shù)據(jù)庫賬號的權(quán)限要求。
   	數(shù)據(jù)庫密碼	填入該數(shù)據(jù)庫賬號對應(yīng)的密碼。
   	連接方式	DTS支持非加密連接、SSL安全連接和Mongo Atlas SSL三種連接方式。連接方式的選項與接入方式和架構(gòu)類型有關(guān)，請以控制臺為準(zhǔn)。 說明 架構(gòu)類型為分片集群架構(gòu)，且遷移方式為Oplog的MongoDB數(shù)據(jù)庫，不支持SSL安全連接。 若源庫為自建（接入方式不為云實例）副本集架構(gòu)的MongoDB數(shù)據(jù)庫，并且選擇了SSL安全連接，DTS還支持上傳CA證書對連接進行校驗。
   目標(biāo)庫信息	選擇已有連接信息	您可以按實際需求，選擇是否使用已有數(shù)據(jù)庫實例。 如使用已有實例，下方數(shù)據(jù)庫信息將自動填入，您無需重復(fù)輸入。 如不使用已有實例，您需要配置下方的數(shù)據(jù)庫信息。 說明 您可以在數(shù)據(jù)連接管理頁面或新版配置頁面，將數(shù)據(jù)庫錄入DTS。更多信息，請參見數(shù)據(jù)連接管理。 DMS控制臺的配置項為選擇DMS數(shù)據(jù)庫實例，您可以單擊新增DMS數(shù)據(jù)庫實例或在控制臺首頁將數(shù)據(jù)庫錄入DMS。更多信息，請參見云數(shù)據(jù)庫錄入和他云/自建數(shù)據(jù)庫錄入。
   	數(shù)據(jù)庫類型	選擇MySQL。
   	接入方式	選擇云實例。
   	實例地區(qū)	選擇目標(biāo)RDS MySQL實例所屬的地域。
   	是否跨阿里云賬號	本示例使用當(dāng)前阿里云賬號下的數(shù)據(jù)庫實例，需選擇不跨賬號。
   	RDS實例ID	選擇目標(biāo)RDS MySQL實例的ID。
   	數(shù)據(jù)庫賬號	填入目標(biāo)RDS MySQL實例的數(shù)據(jù)庫賬號。權(quán)限要求，請參見數(shù)據(jù)庫賬號的權(quán)限要求。
   	數(shù)據(jù)庫密碼	填入該數(shù)據(jù)庫賬號對應(yīng)的密碼。
   	連接方式	根據(jù)需求選擇非加密連接或SSL安全連接。如果設(shè)置為SSL安全連接，您需要提前開啟RDS MySQL實例的SSL加密功能，詳情請參見使用云端證書快速開啟SSL鏈路加密。

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

   說明

   • 請確保DTS服務(wù)的IP地址段能夠被自動或手動添加至源庫和目標(biāo)庫的安全設(shè)置中，以允許DTS服務(wù)器的訪問。更多信息，請參見添加DTS服務(wù)器的IP地址段。

   • 若源庫或目標(biāo)庫為自建數(shù)據(jù)庫（接入方式不是云實例），則還需要在彈出的DTS服務(wù)器訪問授權(quán)對話框單擊測試連接。

6. 配置任務(wù)對象。

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

      配置	說明
      同步類型	固定選中增量同步。僅支持選中全量同步，不支持庫表結(jié)構(gòu)同步。預(yù)檢查完成后，DTS會將源實例中待同步對象的數(shù)據(jù)在目標(biāo)集群中初始化，作為后續(xù)增量同步數(shù)據(jù)的基線數(shù)據(jù)。
      目標(biāo)已存在表的處理模式	預(yù)檢查并報錯攔截：檢查目標(biāo)數(shù)據(jù)庫中是否有同名的表。如果目標(biāo)數(shù)據(jù)庫中沒有同名的表，則通過該檢查項目；如果目標(biāo)數(shù)據(jù)庫中有同名的表，則在預(yù)檢查階段提示錯誤，數(shù)據(jù)同步任務(wù)不會被啟動。 說明 如果目標(biāo)庫中同名的表不方便刪除或重命名，您可以更改該表在目標(biāo)庫中的名稱，請參見庫表列名映射。 忽略報錯并繼續(xù)執(zhí)行：跳過目標(biāo)數(shù)據(jù)庫中是否有同名表的檢查項。 警告 選擇為忽略報錯并繼續(xù)執(zhí)行，可能導(dǎo)致數(shù)據(jù)不一致，給業(yè)務(wù)帶來風(fēng)險，例如： 表結(jié)構(gòu)一致的情況下，如在目標(biāo)庫遇到與源庫主鍵或唯一鍵的值相同的記錄： 全量期間，DTS會保留目標(biāo)集群中的該條記錄，即源庫中的該條記錄不會同步至目標(biāo)數(shù)據(jù)庫中。 增量期間，DTS不會保留目標(biāo)集群中的該條記錄，即源庫中的該條記錄會覆蓋至目標(biāo)數(shù)據(jù)庫中。 表結(jié)構(gòu)不一致的情況下，可能會導(dǎo)致無法初始化數(shù)據(jù)、只能同步部分列的數(shù)據(jù)或同步失敗，請謹(jǐn)慎操作。
      目標(biāo)庫對象名稱大小寫策略	您可以配置目標(biāo)實例中同步對象的庫名、表名和列名的英文大小寫策略。默認(rèn)情況下選擇DTS默認(rèn)策略，您也可以選擇與源庫、目標(biāo)庫默認(rèn)策略保持一致。更多信息，請參見目標(biāo)庫對象名稱大小寫策略。
      源庫對象	在源庫對象框中單擊待同步對象，然后單擊將其移動至已選擇對象框。 說明 同步對象的選擇粒度為集合。
      已選擇對象	編輯庫名映射。 右鍵單擊已選擇對象中的待同步集合所屬的數(shù)據(jù)庫。 將Schema名稱修改為目標(biāo)RDS MySQL實例中接收數(shù)據(jù)的數(shù)據(jù)庫名稱。 單擊確定。 編輯表名映射。 右鍵單擊已選擇對象中的待同步的集合。 將表名稱修改為目標(biāo)RDS MySQL實例中接收數(shù)據(jù)的表名稱。 可選：為全量同步設(shè)置過濾條件，設(shè)置方法請參見設(shè)置過濾條件。 可選：在勾選所需同步的DML&DDL操作區(qū)域選擇所需增量同步的操作。 配置MongoDB中需要同步的字段（Field）。 DTS默認(rèn)會對待同步集合的數(shù)據(jù)進行映射，在賦值列配置表達式。您需要檢查表達式是否符合您的要求，并配置列名稱、類型、長度和精度等信息。 重要 目標(biāo)表的主鍵列必須賦值為bson_value("_id")。 在配置bson_value()表達式時，需要按照層級關(guān)系配置到最小子字段，否則可能會導(dǎo)致數(shù)據(jù)丟失或任務(wù)失敗。 在賦值列的bson_value()表達式中，查看該行數(shù)據(jù)在MongoDB中的字段名稱。 ""中的字段，即為MongoDB中的字段名稱。例如，表達式為bson_value("age")，則該行數(shù)據(jù)對應(yīng)MongoDB中的age字段。 可選：刪除無需同步的字段。 說明 對于無需同步的字段，您可以單擊該行數(shù)據(jù)后的。 配置待同步的字段。 根據(jù)bson_value()表達式是否符合您的要求，進行后續(xù)操作。 表達式符合要求的字段 填寫列名稱。 說明 此處填寫的是目標(biāo)RDS MySQL實例中接收數(shù)據(jù)表的列名。 選擇列數(shù)據(jù)的類型。 重要 請務(wù)必確保目標(biāo)表的數(shù)據(jù)類型與源MongoDB的數(shù)據(jù)兼容。數(shù)據(jù)類型映射關(guān)系，請參見數(shù)據(jù)類型映射。 可選：配置列數(shù)據(jù)的長度和精度。 重復(fù)上述操作，將相關(guān)字段逐一進行映射。 表達式不符合要求的字段 說明 例如，含層級關(guān)系（父子結(jié)構(gòu)）的字段。 在操作列，單擊該行數(shù)據(jù)后的。 單擊+ 新增列。 配置列名稱、類型、長度和精度。 在賦值下方的文本框中填寫bson_value()表達式，詳情請參見賦值配置示例。 重復(fù)上述操作，將相關(guān)字段逐一進行映射。 單擊確定。

   2. 單擊下一步高級配置，進行高級參數(shù)配置。

      配置	說明
      選擇調(diào)度該任務(wù)的專屬集群	DTS默認(rèn)將任務(wù)調(diào)度到共享集群上，您無需選擇。若您希望任務(wù)更加穩(wěn)定，可以購買專屬集群來運行DTS同步任務(wù)。更多信息，請參見什么是DTS專屬集群。
      源庫、目標(biāo)庫無法連接后的重試時間	在同步任務(wù)啟動后，若源庫或目標(biāo)庫連接失敗則DTS會報錯，并會立即進行持續(xù)的重試連接，默認(rèn)持續(xù)重試時間為720分鐘，您也可以在取值范圍（10~1440分鐘）內(nèi)自定義重試時間，建議設(shè)置30分鐘以上。如果DTS在設(shè)置的重試時間內(nèi)重新連接上源庫、目標(biāo)庫，同步任務(wù)將自動恢復(fù)。否則，同步任務(wù)將會失敗。 說明 針對同源或者同目標(biāo)的多個DTS實例，如DTS實例A和DTS實例B，設(shè)置網(wǎng)絡(luò)重試時間時A設(shè)置30分鐘，B設(shè)置60分鐘，則重試時間以低的30分鐘為準(zhǔn)。 由于連接重試期間，DTS將收取任務(wù)運行費用，建議您根據(jù)業(yè)務(wù)需要自定義重試時間，或者在源和目標(biāo)庫實例釋放后盡快釋放DTS實例。
      源庫、目標(biāo)庫出現(xiàn)其他問題后的重試時間	在同步任務(wù)啟動后，若源庫或目標(biāo)庫出現(xiàn)非連接性的其他問題（如DDL或DML執(zhí)行異常），則DTS會報錯并會立即進行持續(xù)的重試操作，默認(rèn)持續(xù)重試時間為10分鐘，您也可以在取值范圍（1~1440分鐘）內(nèi)自定義重試時間，建議設(shè)置10分鐘以上。如果DTS在設(shè)置的重試時間內(nèi)相關(guān)操作執(zhí)行成功，同步任務(wù)將自動恢復(fù)。否則，同步任務(wù)將會失敗。 重要 源庫、目標(biāo)庫出現(xiàn)其他問題后的重試時間的值需要小于源庫、目標(biāo)庫無法連接后的重試時間的值。
      是否限制全量遷移速率	在全量同步階段，DTS將占用源庫和目標(biāo)庫一定的讀寫資源，可能會導(dǎo)致數(shù)據(jù)庫的負(fù)載上升。您可以根據(jù)實際情況，選擇是否對全量同步任務(wù)進行限速設(shè)置（設(shè)置每秒查詢源庫的速率QPS、每秒全量遷移的行數(shù)RPS和每秒全量遷移的數(shù)據(jù)量(MB)BPS），以緩解目標(biāo)庫的壓力。 說明 僅當(dāng)同步類型選擇了全量同步時才可以配置。
      同一張表內(nèi)主鍵_id的數(shù)據(jù)類型是否唯一	待同步的數(shù)據(jù)中，同一個集合內(nèi)主鍵_id的數(shù)據(jù)類型是否唯一。 說明 僅當(dāng)同步類型選擇了全量同步時才可以配置。 是：唯一。在全量同步階段，DTS將不會掃描源庫待同步數(shù)據(jù)中主鍵的數(shù)據(jù)類型。 否：不唯一。在全量同步階段，DTS將掃描源庫待同步數(shù)據(jù)中主鍵的數(shù)據(jù)類型。
      是否限制增量同步速率	您也可以根據(jù)實際情況，選擇是否對增量同步任務(wù)進行限速設(shè)置（設(shè)置每秒增量同步的行數(shù)RPS和每秒增量同步的數(shù)據(jù)量(MB)BPS），以緩解目標(biāo)庫的壓力。
      環(huán)境標(biāo)簽	您可以根據(jù)實際情況，選擇用于標(biāo)識實例的環(huán)境標(biāo)簽。本示例無需選擇。
      配置ETL功能	選擇是否配置ETL功能。關(guān)于ETL的更多信息，請參見什么是ETL。 是：配置ETL功能，并在文本框中填寫數(shù)據(jù)處理語句，詳情請參見在DTS遷移或同步任務(wù)中配置ETL。 否：不配置ETL功能。
      監(jiān)控告警	是否設(shè)置告警，當(dāng)同步失敗或延遲超過閾值后，將通知告警聯(lián)系人。 不設(shè)置：不設(shè)置告警。 設(shè)置：設(shè)置告警，您還需要設(shè)置告警閾值和告警聯(lián)系人。更多信息，請參見在配置任務(wù)過程中配置監(jiān)控告警。

7. 保存任務(wù)并進行預(yù)檢查。

   • 若您需要查看調(diào)用API接口配置該實例時的參數(shù)信息，請將鼠標(biāo)光標(biāo)移動至下一步保存任務(wù)并預(yù)檢查按鈕上，然后單擊氣泡中的預(yù)覽OpenAPI參數(shù)。

   • 若您無需查看或已完成查看API參數(shù)，請單擊頁面下方的下一步保存任務(wù)并預(yù)檢查。

   說明

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

   • 如果預(yù)檢查失敗，請單擊失敗檢查項后的查看詳情，并根據(jù)提示修復(fù)后重新進行預(yù)檢查。

   • 如果預(yù)檢查產(chǎn)生警告：

     • 對于不可以忽略的檢查項，請單擊失敗檢查項后的查看詳情，并根據(jù)提示修復(fù)后重新進行預(yù)檢查。

     • 對于可以忽略無需修復(fù)的檢查項，您可以依次單擊點擊確認(rèn)告警詳情、確認(rèn)屏蔽、確定、重新進行預(yù)檢查，跳過告警檢查項重新進行預(yù)檢查。如果選擇屏蔽告警檢查項，可能會導(dǎo)致數(shù)據(jù)不一致等問題，給業(yè)務(wù)帶來風(fēng)險。

8. 購買實例。

   1. 預(yù)檢查通過率顯示為100%時，單擊下一步購買。

   2. 在購買頁面，選擇數(shù)據(jù)同步實例的計費方式、鏈路規(guī)格，詳細(xì)說明請參見下表。

      類別	參數(shù)	說明
      信息配置	計費方式	預(yù)付費（包年包月）：在新建實例時支付費用。適合長期需求，價格比按量付費更實惠，且購買時長越長，折扣越多。 后付費（按量付費）：按小時扣費。適合短期需求，用完可立即釋放實例，節(jié)省費用。
      	資源組配置	實例所屬的資源組，默認(rèn)為default resource group。更多信息，請參見什么是資源管理。
      	鏈路規(guī)格	DTS為您提供了不同性能的同步規(guī)格，同步鏈路規(guī)格的不同會影響同步速率，您可以根據(jù)業(yè)務(wù)場景進行選擇。更多信息，請參見數(shù)據(jù)同步鏈路規(guī)格說明。
      	訂購時長	在預(yù)付費模式下，選擇包年包月實例的時長和數(shù)量，包月可選擇1~9個月，包年可選擇1年、2年、3年和5年。 說明 該選項僅在付費類型為預(yù)付費時出現(xiàn)。

   3. 配置完成后，閱讀并勾選《數(shù)據(jù)傳輸（按量付費）服務(wù)條款》。

   4. 單擊購買并啟動，并在彈出的確認(rèn)對話框，單擊確定。

      您可在數(shù)據(jù)同步界面查看具體任務(wù)進度。

數(shù)據(jù)類型映射

賦值配置示例

{
  "_id":"62cd344c85c1ea6a2a9f****",
  "person":{
    "name":"neo",
    "age":26,
    "sex":"male"
  }
}