注意事項

• DTS在執(zhí)行全量數(shù)據(jù)初始化時將占用源庫和目標庫一定的讀寫資源，可能會導(dǎo)致數(shù)據(jù)庫的負載上升，在數(shù)據(jù)庫性能較差、規(guī)格較低或業(yè)務(wù)量較大的情況下（例如源庫有大量慢SQL、存在無主鍵表或目標庫存在死鎖等），可能會加重數(shù)據(jù)庫壓力，甚至導(dǎo)致數(shù)據(jù)庫服務(wù)不可用。因此您需要在執(zhí)行數(shù)據(jù)同步前評估源庫和目標庫的性能，同時建議您在業(yè)務(wù)低峰期執(zhí)行數(shù)據(jù)同步（例如源庫和目標庫的CPU負載在30%以下）。

• 請勿在數(shù)據(jù)同步時，對源庫的同步對象使用gh-ost或pt-online-schema-change等類似工具執(zhí)行在線DDL變更，否則會導(dǎo)致同步失敗。

  說明

  如果同步的目標為云原生數(shù)據(jù)倉庫AnalyticDB MySQL（3.0），您可以使用DMS提供的相關(guān)功能來執(zhí)行在線DDL變更，詳情請參見通過無鎖變更工單實現(xiàn)無鎖結(jié)構(gòu)變更。

• 由于云原生數(shù)據(jù)倉庫AnalyticDB MySQL（3.0）本身的使用限制，當云原生數(shù)據(jù)倉庫AnalyticDB MySQL（3.0）集群中的節(jié)點磁盤空間使用量超過80%，該集群將被鎖定。請?zhí)崆案鶕?jù)待同步的對象預(yù)估所需空間，確保目標集群具備充足的存儲空間。

• 暫不支持同步前綴索引，如果源庫存在前綴索引可能導(dǎo)致數(shù)據(jù)同步失敗。

• 若DTS任務(wù)運行時目標AnalyticDB MySQL版 3.0集群處于備份中的狀態(tài)，則會導(dǎo)致任務(wù)失敗。

費用說明

術(shù)語/概念對應(yīng)關(guān)系

支持同步的SQL操作

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

數(shù)據(jù)類型映射關(guān)系

由于MySQL和云原生數(shù)據(jù)倉庫AnalyticDB MySQL的數(shù)據(jù)類型并不是一一對應(yīng)的，所以DTS在進行結(jié)構(gòu)初始化時，會根據(jù)數(shù)據(jù)類型定義進行類型映射，詳情請參見結(jié)構(gòu)初始化涉及的數(shù)據(jù)類型映射關(guān)系。

操作步驟

1. 購買數(shù)據(jù)同步作業(yè)，詳情請參見購買流程。

   說明

   購買時，選擇源實例為MySQL，目標實例為AnalyticDB MySQL，并選擇同步拓撲為單向同步。

2. 登錄數(shù)據(jù)傳輸控制臺。

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

4. 在同步作業(yè)列表頁面頂部，選擇數(shù)據(jù)同步實例所屬地域。

5. 定位至已購買的數(shù)據(jù)同步實例，單擊配置同步鏈路。

6. 配置同步通道的源實例及目標實例信息。

   

   類別	配置	說明
   無	同步作業(yè)名稱	DTS會自動生成一個同步作業(yè)名稱，建議配置具有業(yè)務(wù)意義的名稱（無唯一性要求），便于后續(xù)識別。
   源實例信息	實例類型	選擇RDS實例。
   	實例地區(qū)	購買數(shù)據(jù)同步實例時選擇的源實例地域信息，不可變更。
   	實例ID	選擇源RDS實例ID。
   	數(shù)據(jù)庫賬號	填入源RDS的數(shù)據(jù)庫賬號，權(quán)限要求請參見數(shù)據(jù)庫賬號的權(quán)限要求。 說明 當源RDS實例的數(shù)據(jù)庫類型為MySQL 5.5或MySQL 5.6時，無需配置數(shù)據(jù)庫賬號和數(shù)據(jù)庫密碼。
   	數(shù)據(jù)庫密碼	填入該數(shù)據(jù)庫賬號對應(yīng)的密碼。
   	連接方式	根據(jù)需求選擇非加密連接或SSL安全連接。如果設(shè)置為SSL安全連接，您需要提前開啟RDS實例的SSL加密功能，詳情請參見設(shè)置SSL加密。
   目標實例信息	實例類型	固定為ADS，不可變更。
   	實例地區(qū)	購買數(shù)據(jù)同步實例時選擇的目標實例地域信息，不可變更。
   	版本	根據(jù)目標云原生數(shù)據(jù)倉庫AnalyticDB MySQL集群的版本，選擇2.0或3.0。 說明 選擇為2.0后，無需配置數(shù)據(jù)庫賬號和數(shù)據(jù)庫密碼。 選擇為3.0后，您還需要配置數(shù)據(jù)庫賬號和數(shù)據(jù)庫密碼，權(quán)限要求請參見數(shù)據(jù)庫賬號的權(quán)限要求。
   	數(shù)據(jù)庫	選擇目標云原生數(shù)據(jù)倉庫AnalyticDB MySQL的集群ID。
   	數(shù)據(jù)庫賬號	填入云原生數(shù)據(jù)倉庫AnalyticDB MySQL的數(shù)據(jù)庫賬號。
   	數(shù)據(jù)庫密碼	填入該數(shù)據(jù)庫賬號對應(yīng)的密碼。

7. 單擊頁面右下角的授權(quán)白名單并進入下一步。

   如果源或目標數(shù)據(jù)庫是阿里云數(shù)據(jù)庫實例（例如RDS MySQL、云數(shù)據(jù)庫MongoDB版等），DTS會自動將對應(yīng)地區(qū)DTS服務(wù)的IP地址添加到阿里云數(shù)據(jù)庫實例的白名單中；如果源或目標數(shù)據(jù)庫是ECS上的自建數(shù)據(jù)庫，DTS會自動將對應(yīng)地區(qū)DTS服務(wù)的IP地址添到ECS的安全規(guī)則中，您還需確保自建數(shù)據(jù)庫沒有限制ECS的訪問（若數(shù)據(jù)庫是集群部署在多個ECS實例，您需要手動將DTS服務(wù)對應(yīng)地區(qū)的IP地址添到其余每個ECS的安全規(guī)則中）；如果源或目標數(shù)據(jù)庫是IDC自建數(shù)據(jù)庫或其他云數(shù)據(jù)庫，則需要您手動添加對應(yīng)地區(qū)DTS服務(wù)的IP地址，以允許來自DTS服務(wù)器的訪問。DTS服務(wù)的IP地址，請參見DTS服務(wù)器的IP地址段。

   警告

   DTS自動添加或您手動添加DTS服務(wù)的公網(wǎng)IP地址段可能會存在安全風(fēng)險，一旦使用本產(chǎn)品代表您已理解和確認其中可能存在的安全風(fēng)險，并且需要您做好基本的安全防護，包括但不限于加強賬號密碼強度防范、限制各網(wǎng)段開放的端口號、內(nèi)部各API使用鑒權(quán)方式通信、定期檢查并限制不需要的網(wǎng)段，或者使用通過內(nèi)網(wǎng)（專線/VPN網(wǎng)關(guān)/智能網(wǎng)關(guān)）的方式接入。

8. 配置同步策略及對象信息。

   

   配置	說明
   同步初始化	默認情況下，您需要同時選中結(jié)構(gòu)初始化和全量數(shù)據(jù)初始化。預(yù)檢查完成后，DTS會將源實例中待同步對象的結(jié)構(gòu)及數(shù)據(jù)在目標集群中初始化，作為后續(xù)增量同步數(shù)據(jù)的基線數(shù)據(jù)。
   目標已存在表的處理模式	預(yù)檢查并報錯攔截：檢查目標數(shù)據(jù)庫中是否有同名的表。如果目標數(shù)據(jù)庫中沒有同名的表，則通過該檢查項目；如果目標數(shù)據(jù)庫中有同名的表，則在預(yù)檢查階段提示錯誤，數(shù)據(jù)同步作業(yè)不會被啟動。 說明 如果目標庫中同名的表不方便刪除或重命名，您可以更改該表在目標庫中的名稱，詳情請參見設(shè)置同步對象在目標實例中的名稱。 忽略報錯并繼續(xù)執(zhí)行：跳過目標數(shù)據(jù)庫中是否有同名表的檢查項。 警告 選擇為忽略報錯并繼續(xù)執(zhí)行，可能導(dǎo)致數(shù)據(jù)不一致，給業(yè)務(wù)帶來風(fēng)險，例如： 表結(jié)構(gòu)一致的情況下，在目標庫遇到與源庫主鍵的值相同的記錄，則會保留目標集群中的該條記錄，即源庫中的該條記錄不會同步至目標數(shù)據(jù)庫中。 表結(jié)構(gòu)不一致的情況下，可能會導(dǎo)致無法初始化數(shù)據(jù)、只能同步部分列的數(shù)據(jù)或同步失敗。
   多表歸并	選擇為是：DTS將在每個表中增加__dts_data_source列來存儲數(shù)據(jù)來源，且不再支持DDL同步。 選擇為否：默認選項，支持DDL同步。 說明 多表歸并功能基于任務(wù)級別，即不支持基于表級別執(zhí)行多表歸并。如果需要讓部分表執(zhí)行多表歸并，另一部分不執(zhí)行多表歸并，您可以創(chuàng)建兩個數(shù)據(jù)同步作業(yè)。
   同步操作類型	根據(jù)業(yè)務(wù)選中需要同步的操作類型，支持的同步操作詳情請參見支持同步的SQL操作，默認情況下都處于選中狀態(tài)。
   選擇同步對象	在源庫對象框中單擊待同步的對象，然后單擊圖標將其移動至已選擇對象框。 同步對象的選擇粒度為庫、表。 說明 如果選擇整個庫作為同步對象，那么該庫中所有對象的結(jié)構(gòu)變更操作會同步至目標庫。 如果選擇某個表作為同步對象，那么只有這個表的ADD COLUMN操作會同步至目標庫。 默認情況下，同步對象的名稱保持不變。如果您需要同步對象在目標集群上名稱不同，請使用對象名映射功能，詳情請參見設(shè)置同步對象在目標實例中的名稱。
   映射名稱更改	如需更改同步對象在目標實例中的名稱，請使用對象名映射功能，詳情請參見庫表列映射。
   源表DMS_ONLINE_DDL過程中是否復(fù)制臨時表到目標庫	如源庫使用數(shù)據(jù)管理DMS（Data Management）執(zhí)行Online DDL變更，您可以選擇是否同步Online DDL變更產(chǎn)生的臨時表數(shù)據(jù)。 是：同步Online DDL變更產(chǎn)生的臨時表數(shù)據(jù)。 說明 Online DDL變更產(chǎn)生的臨時表數(shù)據(jù)過大，可能會導(dǎo)致同步任務(wù)延遲。 否：不同步Online DDL變更產(chǎn)生的臨時表數(shù)據(jù)，只同步源庫的原始DDL數(shù)據(jù)。 說明 該方案會導(dǎo)致目標庫鎖表。
   源、目標庫無法連接重試時間	當源、目標庫無法連接時，DTS默認重試720分鐘（即12小時），您也可以自定義重試時間。如果DTS在設(shè)置的時間內(nèi)重新連接上源、目標庫，同步任務(wù)將自動恢復(fù)。否則，同步任務(wù)將失敗。 說明 由于連接重試期間，DTS將收取任務(wù)運行費用，建議您根據(jù)業(yè)務(wù)需要自定義重試時間，或者在源和目標庫實例釋放后盡快釋放DTS實例。

9. 上述配置完成后，單擊頁面右下角的下一步。

10. 設(shè)置待同步的表在目標庫中類型。

    

    說明

    選擇了結(jié)構(gòu)初始化后，您需要定義待同步的表在云原生數(shù)據(jù)倉庫AnalyticDB MySQL中的類型、主鍵列、分區(qū)列等信息，詳情請參見ADB 2.0 SQL手冊和ADB 3.0 SQL手冊。

11. 上述配置完成后，單擊頁面右下角的預(yù)檢查并啟動。

    說明

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

    • 如果預(yù)檢查失敗，單擊具體檢查項后的，查看失敗詳情。

      • 您可以根據(jù)提示修復(fù)后重新進行預(yù)檢查。

      • 如無需修復(fù)告警檢測項，您也可以選擇確認屏蔽、忽略告警項并重新進行預(yù)檢查，跳過告警檢測項重新進行預(yù)檢查。

12. 在預(yù)檢查對話框中顯示預(yù)檢查通過后，關(guān)閉預(yù)檢查對話框，同步作業(yè)將正式開始。

13. 等待同步作業(yè)的鏈路初始化完成，直至處于同步中狀態(tài)。

    您可以在數(shù)據(jù)同步頁面，查看數(shù)據(jù)同步作業(yè)的狀態(tài)。

    

修復(fù)因變更字段類型導(dǎo)致的同步失敗

如果在數(shù)據(jù)同步的過程中變更了源表的字段類型，同步作業(yè)將報錯并中斷。您可參照如下的方法來手動修復(fù)。

1. 在目標實例中，根據(jù)同步失敗的表A（表名以customer為例），重新創(chuàng)建一個新表B（表名以customer_new為例），確保兩張表的表結(jié)構(gòu)保持一致。

2. 通過INSERT INTO SELECT命令，將表A的數(shù)據(jù)復(fù)制并插入到新創(chuàng)建的表B中，確保兩張表的數(shù)據(jù)保持一致。

3. 重命名或刪除同步失敗的表A，然后將表B的名稱修改為customer。

4. 在DTS控制臺，重新啟動數(shù)據(jù)同步作業(yè)。