前提條件

• 已創建源PolarDB-X 2.0實例，且需兼容MySQL 5.7版本。

• 已創建目標Elasticsearch，請參見創建阿里云Elasticsearch實例。

• 源和目標支持的版本，請參見同步方案概覽。

• 目標Elasticsearch實例存儲空間須大于源PolarDB-X 2.0實例。

注意事項

費用說明

支持的同步架構

• 一對一單向同步

• 一對多單向同步

• 多對一單向同步

關于各類同步架構的介紹及注意事項，請參見數據同步拓撲介紹。

支持同步的SQL操作

映射關系

由于PolarDB-X 2.0兼容的MySQL與Elasticsearch實例支持的數據類型不同，數據類型無法完全對應。DTS在進行庫結構同步時，會根據Elasticsearch實例支持的數據類型進行類型映射，請參見結構初始化涉及的數據類型映射關系。

操作步驟

1. 進入同步任務的列表頁面。

   1. 登錄DMS數據管理服務。

   2. 在頂部菜單欄中，單擊集成與開發。

   3. 在左側導航欄，選擇數據傳輸（DTS） > 數據同步。

   說明

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

   • 您也可以登錄新版DTS同步任務的列表頁面。

2. 在同步任務右側，選擇同步實例所屬地域。

   說明

   新版DTS同步任務列表頁面，需要在頁面左上角選擇同步實例所屬地域。

3. 單擊創建任務，進入任務配置頁面。

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

   說明

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

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

5. 配置源庫及目標庫信息。

   警告

   選擇源和目標實例后，建議您仔細閱讀頁面上方顯示的使用限制，否則可能會導致任務失敗或數據不一致。

   類別	配置	說明
   無	任務名稱	DTS會自動生成一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便于后續識別。
   源庫信息	數據庫類型	選擇PolarDB-X 2.0。
   	接入方式	選擇云實例。
   	實例地區	選擇源PolarDB-X 2.0實例所屬地域。
   	是否跨阿里云賬號	本示例使用當前阿里云賬號下的數據庫實例，需選擇不跨賬號。
   	實例ID	選擇源PolarDB-X 2.0實例ID。
   	數據庫賬號	填入源PolarDB-X 2.0實例的數據庫賬號，需具備REPLICATION SLAVE、REPLICATION CLIENT及待同步對象的SELECT權限。 說明 授權方式，請參見數據同步過程中的賬號權限問題。
   	數據庫密碼	填入該數據庫賬號對應的密碼。
   目標庫信息	數據庫類型	選擇Elasticsearch。
   	接入方式	選擇云實例。
   	實例地區	選擇目標Elasticsearch實例所屬地域。
   	類型	請根據實際情況，選擇集群版或Serverless。
   	實例ID	選擇目標Elasticsearch實例ID。
   	數據庫賬號	填入目標Elasticsearch實例的數據庫賬號，需具備讀寫權限，通常為elastic。
   	數據庫密碼	填入該數據庫賬號對應的密碼。
   	連接方式	請根據實際情況，選擇HTTP或HTTPS。

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

   如果源或目標數據庫是阿里云數據庫實例（例如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網關/智能網關）的方式接入。

7. 配置任務對象。

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

      配置	說明
      同步類型	固定選中增量同步。默認情況下，您還需要同時選中庫表結構同步和全量同步。預檢查完成后，DTS會將源實例中待同步對象的全量數據在目標集群中初始化，作為后續增量同步數據的基線數據。
      索引名稱	表名 選擇為表名后，在目標Elasticsearch實例中創建的索引名稱和表名一致，在本案例中即為order。 庫名_表名 選擇為庫名_表名后，在目標Elasticsearch實例中創建的索引名稱為庫名_表名，在本案例中即為dtstest_order。
      目標已存在表的處理模式	預檢查并報錯攔截：檢查目標數據庫中是否有同名的表。如果目標數據庫中沒有同名的表，則通過該檢查項目；如果目標數據庫中有同名的表，則在預檢查階段提示錯誤，數據同步任務不會被啟動。 說明 如果目標庫中同名的表不方便刪除或重命名，您可以更改該表在目標庫中的名稱，請參見庫表列名映射。 忽略報錯并繼續執行：跳過目標數據庫中是否有同名表的檢查項。 警告 選擇為忽略報錯并繼續執行，可能導致數據不一致，給業務帶來風險，例如： 表結構一致的情況下，如在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄： 全量期間，DTS會保留目標集群中的該條記錄，即源庫中的該條記錄不會同步至目標數據庫中。 增量期間，DTS不會保留目標集群中的該條記錄，即源庫中的該條記錄會覆蓋至目標數據庫中。 表結構不一致的情況下，可能會導致無法初始化數據、只能同步部分列的數據或同步失敗，請謹慎操作。
      目標庫對象名稱大小寫策略	您可以配置目標實例中同步對象的庫名、表名和列名的英文大小寫策略。默認情況下選擇DTS默認策略，您也可以選擇與源庫、目標庫默認策略保持一致。更多信息，請參見目標庫對象名稱大小寫策略。
      源庫對象	在源庫對象框中單擊待同步對象，然后單擊將其移動至已選擇對象框。 說明 同步對象選擇的粒度為庫、表、列。若選擇的同步對象為表或列，其他對象（如視圖、觸發器、存儲過程）不會被同步至目標庫。
      已選擇對象	如需更改單個同步對象在目標實例中的名稱，請右擊已選擇對象中的同步對象，設置方式，請參見庫表列名單個映射。 如需批量更改同步對象在目標實例中的名稱，請單擊已選擇對象方框右上方的批量編輯，設置方式，請參見庫表列名批量映射。 說明 如需按庫或表級別選擇同步的SQL操作，請在已選擇對象中右擊待同步對象，并在彈出的對話框中選擇所需同步的SQL操作。支持的操作，請參見支持同步的SQL操作。 如需設置WHERE條件過濾數據，請在已選擇對象中右擊待同步的表，在彈出的對話框中設置過濾條件。設置方法請參見通過SQL條件過濾任務數據。 如果使用了對象名映射功能，可能會導致依賴這個對象的其他對象同步失敗。

   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），以緩解目標庫的壓力。 說明 僅當同步類型選擇了全量同步時才可以配置。
      是否限制增量同步速率	您也可以根據實際情況，選擇是否對增量同步任務進行限速設置（設置每秒增量同步的行數RPS和每秒增量同步的數據量(MB)BPS），以緩解目標庫的壓力。
      環境標簽	您可以根據實際情況，選擇用于標識實例的環境標簽。本示例無需選擇。
      分片配置	根據目標Elasticsearch中索引的最大分片配置，設置索引的主分片和副本分片的數量。
      字符串Index	同步至目標Elasticsearch實例中的字符串編入索引的方式。 analyzed：先分析字符串，再編入索引。您還需要選擇具體的分析器，分析器的類型及作用，請參見分析器。 not analyzed：不分析，直接使用原始值編入索引。 no：不編入索引。
      時區	DTS同步時間類型的數據（如DATETIME, TIMESTAMP）至目標Elasticsearch實例時，您可以選擇所帶時區。 說明 如目標實例中此類時間類型數據無需帶有時區，則在同步前您需在目標實例中設置該時間類型數據的文檔類型（type）。
      DOCID取值	DOCID默認為表的主鍵，如表中無主鍵，則DOCID為Elasticsearch自動生成的ID列。
      是否去除正反向任務的心跳表sql	根據業務需求選擇是否在DTS實例運行時，在源庫中寫入心跳SQL信息。 是：不在源庫中寫入心跳SQL信息，DTS實例可能會顯示有延遲。 否：在源庫中寫入心跳SQL信息，可能會影響源庫的物理備份和克隆等功能。
      配置ETL功能	選擇是否配置ETL功能。關于ETL的更多信息，請參見什么是ETL。 是：配置ETL功能，并在文本框中填寫數據處理語句，詳情請參見在DTS遷移或同步任務中配置ETL。 否：不配置ETL功能。
      監控告警	是否設置告警，當同步失敗或延遲超過閾值后，將通知告警聯系人。 不設置：不設置告警。 設置：設置告警，您還需要設置告警閾值和告警聯系人。更多信息，請參見在配置任務過程中配置監控告警。

   3. 上述配置完成后，單擊頁面下方的下一步配置庫表字段，設置待同步的表在目標Elasticsearch的_routing策略和_id取值。

      類型	說明
      設置_routing	設置_routing可以將文檔路由存儲在目標Elasticsearch實例的指定分片上，請參見_routing。 選擇為是，您可以自定義列進行路由。 選擇為否，則用_id進行路由。 說明 創建的目標Elasticsearch實例為7.x版本時，您必須選擇為否。
      _id取值	表的主鍵列 聯合主鍵合并為一列。 業務主鍵 如果選擇為業務主鍵，那么您還需要設置對應的業務主鍵列。

8. 保存任務并進行預檢查。

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

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

   說明

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

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

   • 如果預檢查產生警告：

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

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

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

10. 購買實例。

    1. 在購買頁面，選擇數據同步實例的計費方式、鏈路規格，詳細說明請參見下表。

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

    2. 配置完成后，閱讀并勾選《數據傳輸（按量付費）服務條款》。

    3. 單擊購買并啟動，并在彈出的確認對話框，單擊確定。

       您可在數據同步界面查看具體任務進度。

查看同步后的索引和數據

數據同步任務處于運行中狀態后，您可以使用數據可視化軟件Kibana連接Elasticsearch實例，確認創建的索引和同步的數據是否符合業務的預期。登錄方式，請參見登錄Kibana控制臺。