全部產品
Search
文件中心

Data Transmission Service:PolarDB MySQL版遷移至Elasticsearch

更新時間:Apr 21, 2026

通過Data Transmission Service,您可以將PolarDB MySQL版遷移至Elasticsearch。

前提條件

注意事項

類型

說明

源庫限制

  • 頻寬要求:源庫所屬的伺服器需具備足夠的出口頻寬,否則將影響資料移轉速率。

  • 待遷移的表需具備主鍵或唯一約束,且欄位具有唯一性,否則可能會導致目標資料庫中出現重複資料。

  • 若遷移對象為表層級,且需進行編輯(如表列名映射),則單次遷移任務待遷移的表數量超過1000時,建議您拆分待遷移的表,分批配置為多個任務,或者配置整庫的遷移任務,否則任務提交後可能會顯示請求報錯。

  • 如需進行增量遷移:

    • 需開啟Binlog日誌,並且需要將loose_polar_log_bin參數設定為on。否則預檢查階段提示報錯,且無法成功啟動資料移轉任務。開啟Binlog日誌和修改參數的方法,請參見開啟Binlog修改參數值

      說明

      PolarDB MySQL版叢集開啟Binlog日誌會佔用一定的儲存空間,需要收取儲存費用。

    • PolarDB MySQL版叢集的Binlog日誌需保留3天及以上(建議保留7天),否則DTS可能會因無法擷取Binlog而導致任務失敗,極端情況下甚至可能會導致資料不一致或資料丟失。由於您所設定的Binlog日誌儲存時間低於DTS要求的時間而導致的問題,不在DTS的SLA保障範圍內。

      說明

      PolarDB MySQL版叢集的Binlog日誌保留時間長度的設定方法,請參見修改儲存時間長度

  • 源庫的操作限制:在庫表結構遷移階段,請勿執行庫或表結構變更的DDL操作,否則資料移轉任務會失敗。

其他限制

  • 如果源庫中待遷移的表需要執行增加列的操作,您只需先在Elasticsearch執行個體中修改對應表的mapping,然後在來源資料庫中執行相應的DDL操作,最後暫停並啟動遷移任務。

  • 不支援將資料移轉至目標端含父子關係或Join field type映射的索引中,否則可能會導致任務異常或目標端資料查詢失敗等情況。

  • 不支援遷移源PolarDB MySQL版唯讀節點。

  • 不支援遷移源PolarDB MySQL版的OSS外表。

  • 不支援遷移INDEX、PARTITION、VIEW、PROCEDURE、FUNCTION、TRIGGER、FK。

  • DTS全量遷移階段不支援資料庫執行個體的主備切換情境。在此情境下,請及時重新設定遷移任務。

  • 全量資料移轉時DTS會佔用源和目標庫一定讀寫資源,可能會導致資料庫的負載上升。建議在執行資料移轉前評估源庫和目標庫的效能,同時在業務低峰期執行資料移轉。

  • 請勿對源庫的遷移對象使用pt-online-schema-change等類似工具執行線上DDL變更,否則會導致遷移失敗。

  • 對於資料類型為FLOAT或DOUBLE的列,DTS會通過ROUND(COLUMN,PRECISION)來讀取這兩類列的值。如果沒有明確定義其精度,DTS預設對FLOAT的遷移精度為38位,對DOUBLE的遷移精度為308位,請確認遷移精度是否符合業務預期。

  • DTS會嘗試恢複七天之內遷移失敗執行個體的任務。因此在業務切換至目標執行個體前,請務必結束或釋放該執行個體,或者將DTS訪問目標執行個體帳號的寫入權限用REVOKE命令回收掉。避免該任務被自動回復,導致源端資料覆蓋目標執行個體的資料。

  • 由於PolarDB MySQL版和Elasticsearch執行個體支援的資料類型不同,資料類型無法一一對應。所以DTS在進行結構初始化時,會根據目標庫支援的資料類型進行類型映射,詳情請參見結構初始化涉及的資料類型映射關係

  • 不支援開發測試型規格的Elasticsearch執行個體。

  • 若執行個體運行失敗,DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中,可能會對該執行個體進行重啟、調整參數等操作。

    說明

    在調整參數時,僅會修改DTS執行個體的參數,不會對資料庫中的參數進行修改。可能修改的參數,包括但不限於修改執行個體參數中的參數。

其他注意事項

DTS會在源庫定時執行CREATE DATABASE IF NOT EXISTS `test`命令以推進Binlog位點。

費用說明

遷移類型

鏈路配置費用

公網流量費用

結構遷移和全量資料移轉

不收費。

當目標庫的接入方式公網IP時收取公網流量費用,詳情請參見計費概述

增量資料移轉

收費,詳情請參見計費概述

遷移類型說明

  • 庫表結構遷移

    DTS將源庫中遷移對象的結構定義遷移到目標庫。

  • 全量遷移

    DTS將源庫中遷移對象的存量資料,全部遷移到目標庫中。

  • 增量遷移

    DTS在全量遷移的基礎上,將源庫的累加式更新資料移轉到目標庫中。通過增量資料移轉可以實現在自建應用不停機的情況下,平滑地完成資料移轉。

支援增量遷移的SQL操作

操作類型

SQL動作陳述式

DML

INSERT、UPDATE、DELETE

說明

不支援遷移使用UPDATE語句移除欄位的操作。

資料庫帳號的許可權要求

資料庫

許可權要求

帳號建立及授權方法

PolarDB MySQL版叢集

待遷移對象的讀許可權

建立和管理資料庫帳號

資料類型映射關係

  • 由於源庫與Elasticsearch執行個體支援的資料類型不同,資料類型無法完全對應。DTS在進行結構初始化時,會根據Elasticsearch執行個體支援的資料類型進行類型映射,詳情請參見結構初始化涉及的資料類型映射關係

    說明

    DTS的結構遷移過程中不會設定mapping中的dynamic參數,實際參數的應用情況將與您的Elasticsearch執行個體的相關設定保持一致。如果源端資料為JSON類型,請確保在同一表的不同行資料中,相同鍵(Key)對應的值(Value)資料類型保持一致。否則,可能會導致DTS同步異常,請參見dynamic

  • Elasticsearch與關係型資料庫的映射關係因Elasticsearch版本不同而有差異。

    重要

    Elasticsearch 7.0起不再支援一個索引(index)中包含多個文件類型(type),Elasticsearch 8.0已完全移除文件類型(type)的概念。DTS在配置同步或遷移任務時,預設將關係型資料庫中的表映射為Elasticsearch中的索引(index),您可以在配置同步或遷移對象時修改映射關係。

    Elasticsearch 7.0及以後版本

    Elasticsearch

    關係型資料庫

    索引(index)

    表(Table)

    文檔(document)

    一行資料(Row)

    欄位(field)

    一列資料(Column)

    映射(mapping)

    資料庫的組織和結構(Schema)

    Elasticsearch 7.0之前版本

    Elasticsearch

    關係型資料庫

    索引(index)

    資料庫(Database)

    文件類型(type)

    表(Table)

    文檔(document)

    一行資料(Row)

    欄位(field)

    一列資料(Column)

    映射(mapping)

    資料庫的組織和結構(Schema)

操作步驟

  1. 進入目標地區的遷移工作清單頁面(二選一)。

    通過DTS控制台進入

    1. 登入Data Transmission Service控制台

    2. 在左側導覽列,單擊資料移轉

    3. 在頁面左上方,選擇遷移執行個體所屬地區。

    通過DMS控制台進入

    說明

    實際操作可能會因DMS的模式和布局不同,而有所差異。更多資訊。請參見極簡模式控制台自訂DMS介面布局與樣式

    1. 登入Data Management服務

    2. 在頂部功能表列中,選擇Data + AI > 資料轉送(DTS) > 資料移轉

    3. 遷移任務右側,選擇遷移執行個體所屬地區。

  2. 單擊創建任務,進入任務配置頁面。

  3. 配置源庫及目標庫資訊。

    類別

    配置

    說明

    任務名稱

    DTS會自動產生一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便於後續識別。

    源庫資訊

    選擇已有串連資訊

    • 若您需要使用已錄入系統(建立或儲存)的資料庫執行個體,請在下拉式清單中選擇所需的資料庫執行個體,下方的資料庫資訊將自動進行配置。

      說明

      DMS控制台的配置項為選擇DMS資料庫執行個體

    • 若您未將資料庫執行個體錄入到系統,或無需使用已錄入系統的資料庫執行個體,則需要手動設定下方的資料庫資訊。

    資料庫類型

    選擇PolarDB for MySQL

    接入方式

    選擇為雲執行個體

    執行個體地區

    選擇源PolarDB MySQL版執行個體所屬地區。

    是否跨阿里雲帳號

    本樣本為同一阿里雲帳號間遷移,選擇不跨帳號

    PolarDB執行個體ID

    選擇源PolarDB MySQL版執行個體ID。

    資料庫帳號

    填入源PolarDB MySQL版執行個體的資料庫帳號。許可權要求,請參見資料庫帳號的許可權要求

    資料庫密碼

    填入該資料庫帳號對應的密碼。

    串連方式

    請根據實際情況選擇。更多關於SSL加密功能的資訊,請參見設定SSL加密

    目標庫資訊

    選擇已有串連資訊

    • 若您需要使用已錄入系統(建立或儲存)的資料庫執行個體,請在下拉式清單中選擇所需的資料庫執行個體,下方的資料庫資訊將自動進行配置。

      說明

      DMS控制台的配置項為選擇DMS資料庫執行個體

    • 若您未將資料庫執行個體錄入到系統,或無需使用已錄入系統的資料庫執行個體,則需要手動設定下方的資料庫資訊。

    資料庫類型

    選擇Elasticsearch

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇目標Elasticsearch執行個體所屬地區。

    類型

    請根據實際情況,選擇叢集版Serverless

    執行個體ID

    選擇目標Elasticsearch執行個體ID。

    資料庫帳號

    填入Elasticsearch執行個體的資料庫帳號,預設為elastic

    資料庫密碼

    填入建立Elasticsearch執行個體時設定的登入密碼。

    串連方式

    請根據實際情況,選擇HTTPHTTPS

  4. 配置完成後,在頁面下方單擊測試連接以進行下一步

    說明
    • 請確保DTS服務的IP位址區段能夠被自動或手動添加至源庫和目標庫的安全設定中,以允許DTS伺服器的訪問。更多資訊,請參見添加DTS伺服器IP地址白名單

    • 若源庫或目標庫為自建資料庫(接入方式不是雲執行個體),則還需要在彈出的DTS伺服器訪問授權對話方塊單擊測試連接

  5. 配置任務對象。

    1. 對象配置頁面,配置待遷移的對象。

      配置

      說明

      遷移類型

      • 如果只需要進行全量遷移,建議同時選中庫表結構遷移全量遷移

      • 如果需要進行不停機遷移,建議同時選中庫表結構遷移全量遷移增量遷移

      說明
      • 若未選中庫表結構遷移,請確保目標庫中存在接收資料的資料庫和表,並根據實際情況,在已選擇對象框中使用庫表列名映射功能。

      • 若未選中增量遷移,為保障資料一致性,資料移轉期間請勿在源執行個體中寫入新的資料。

      目標已存在表的處理模式

      • 預檢查並報錯攔截:檢查目標資料庫中是否有同名的表。如果目標資料庫中沒有同名的表,則通過該檢查專案;如果目標資料庫中有同名的表,則在預檢查階段提示錯誤,資料同步任務不會被啟動。

        說明

        如果目標庫中同名的表不方便刪除或重新命名,您可以更改該表在目標庫中的名稱,請參見庫表列名映射

      • 忽略報錯並繼續執行:跳過目標資料庫中是否有同名表的檢查項。

        警告

        選擇為忽略報錯並繼續執行,可能導致資料不一致,給業務帶來風險,例如:

        • 表結構一致的情況下,如在目標庫遇到與源庫主鍵的值相同的記錄:

          • 全量期間,DTS會保留目的地組群中的該條記錄,即源庫中的該條記錄不會同步至目標資料庫中。

          • 增量期間,DTS不會保留目的地組群中的該條記錄,即源庫中的該條記錄會覆蓋至目標資料庫中。

        • 表結構不一致的情況下,可能會導致無法初始化資料、只能同步部分列的資料或同步失敗。

      索引名稱

      • 表名

        選擇為表名後,在目標Elasticsearch執行個體中建立的索引名稱和表名一致。

      • 庫名_表名

        選擇為庫名_表名後,在目標Elasticsearch執行個體中建立的索引名稱為庫名_表名。

      目標庫對象名稱大小寫策略

      您可以配置目標執行個體中遷移對象的庫名、表名和列名的英文大小寫策略。預設情況下選擇DTS預設策略,您也可以選擇與源庫、目標庫預設策略保持一致。更多資訊,請參見目標庫對象名稱大小寫策略

      源庫對象

      源庫對象框中選擇待遷移對象,然後單擊向右小箭頭將其移動至已選擇對象框。

      說明

      遷移對象選擇的粒度為庫、表。若選擇的遷移對象為表,其他對象(如視圖、觸發器、預存程序)不會被遷移至目標庫。

      已選擇對象

      • 如需更改單個遷移對象在目標執行個體中的名稱,請右擊已選擇對象中的遷移對象,設定方式,請參見庫表列名單個映射

      • 如需批量更改遷移對象在目標執行個體中的名稱,請單擊已選擇對象方框右上方的大量編輯,設定方式,請參見庫表列名批量映射

      說明
      • 索引名稱和Type名稱支援的特殊字元僅為底線(_)。

      • 如需設定WHERE條件過濾資料,遷移後的索引名稱、Type名稱和列名等資訊,請在已選擇對象中右擊待遷移的表,在彈出的對話方塊中設定。設定方法請參見設定過濾條件

      • 如需按庫或表層級選擇遷移的SQL操作,請在已選擇對象中右擊待遷移對象,並在彈出的對話方塊中選擇所需遷移的SQL操作。支援的操作請參見支援增量遷移的SQL操作

    2. 單擊下一步高級配置,進行進階參數配置。

      配置

      說明

      選擇調度該任務的專屬叢集

      DTS預設將任務調度到共用叢集上,您無需選擇。若您希望任務更加穩定,可以購買專屬叢集來運行DTS遷移任務。

      源庫、目標庫無法串連後的重試時間

      在遷移任務啟動後,若源庫或目標庫串連失敗則DTS會報錯,並會立即進行持續的重試串連,預設重試720分鐘,您也可以在取值範圍(10~1440分鐘)內自訂重試時間,建議設定30分鐘以上。如果DTS在設定的時間內重新串連上源、目標庫,遷移任務將自動回復。否則,遷移任務將失敗。

      說明
      • 針對同源或者同目標的多個DTS執行個體,網路重試時間以後建立任務的設定為準。

      • 由於串連重試期間,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功能。

      監控警示

      根據業務需求選擇是否設定警示並接收警示通知。

      • 不設定:不設定警示。

      • 設定:設定警示。您還需要設定警示閾值警示通知,當遷移失敗或延遲超過閾值後,系統將進行警示通知。

    3. 上述配置完成後,單擊下一步配置庫表欄位,設定待遷移的表在目標在Elasticsearch執行個體中的_routing策略和_id取值。

      名稱

      說明

      是否設定_routing

      設定_routing可以將文檔路由儲存在目標Elasticsearch執行個體的指定分區上,請參見_routing

      • 選擇為,您可以自訂欄進行路由。

      • 選擇為,則用_id進行路由。

      說明

      若您建立的目標Elasticsearch執行個體為7.x版本,請選擇

      _id取值

      • 表的主鍵列

        聯合主鍵合并為一列。

      • 業務主鍵

        如果選擇為業務主鍵,那麼您還需要設定對應的業務主鍵列

  6. 儲存任務並進行預檢查。

    • 若您需要查看調用API介面配置該執行個體時的參數資訊,請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上,然後單擊氣泡中的預覽OpenAPI參數

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

    說明
    • 在遷移任務正式啟動之前,會先進行預檢查。只有預檢查通過後,才能成功啟動遷移任務。

    • 如果預檢查失敗,請單擊失敗檢查項後的查看詳情,並根據提示修複後重新進行預檢查。

    • 如果預檢查產生警告:

      • 對於不可以忽略的檢查項,請單擊失敗檢查項後的查看詳情,並根據提示修複後重新進行預檢查。

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

  7. 購買執行個體。

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

    2. 購買頁面,選擇資料移轉執行個體的鏈路規格,詳細說明請參見下表。

      類別

      參數

      說明

      資訊配置

      資源群組配置

      選擇執行個體所屬的資源群組,預設為default resource group。更多資訊,請參見什麼是資源管理

      鏈路規格

      DTS為您提供了不同效能的遷移規格,遷移鏈路規格的不同會影響遷移速率,您可以根據業務情境進行選擇。更多資訊,請參見資料移轉鏈路規格說明

    3. 配置完成後,閱讀並選中《數據傳輸(隨用隨付)服務條款》

    4. 單擊購買並啟動,並在彈出的確認對話方塊,單擊確定

      您可以在遷移任務列表頁面,查看遷移執行個體的具體進度。

      說明
      • 若遷移執行個體不包含增量遷移任務,則遷移執行個體會自動結束。遷移執行個體自動結束後,運行狀態已完成

      • 若遷移執行個體包含增量遷移任務,則遷移執行個體不會自動結束,增量遷移任務會持續進行。在增量遷移任務正常運行期間,遷移執行個體的運行狀態運行中