全部產品
Search
文件中心

Data Transmission Service:PolarDB-X 2.0遷移至Tablestore

更新時間:Jun 07, 2025

Data Transmission Service支援將PolarDB-X 2.0遷移至Table StoreTablestore。

前提條件

注意事項

類型

說明

源庫限制

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

  • 源庫暫不支援企業版的PolarDB-X 2.0唯讀執行個體。

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

  • 若源端PolarDB-X 2.0待遷移的表名中含大寫字母,則僅支援庫表結構遷移。

  • PolarDB-X 2.0預設已開啟Binlog,您需確保binlog_row_image的參數為full,查看方法請參見參數設定。否則預檢查階段提示報錯,且無法成功啟動資料移轉任務。

  • 源庫的操作限制:

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

    • 遷移期間如需切換PolarDB-X 2.0的網路類型,切換成功後,請調整遷移鏈路的網路連接資訊。

    • 如僅執行全量資料移轉,請勿向源執行個體中寫入新的資料,否則會導致源和目標資料不一致。為即時保持資料一致性,建議選擇結構遷移、全量資料移轉和增量資料移轉。

  • 不支援遷移表組(TABLEGROUP)和包含Locality屬性的庫或表。

其他限制

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

  • 全量初始化會並發執行INSERT操作,導致目標資料庫的表產生片段,因此全量初始化完成後目標執行個體的資料表空間比源執行個體的資料表空間大。

  • 在DTS遷移期間,不允許有除DTS外的資料寫入目標庫,否則可能會導致源庫與目標庫資料不一致。

  • 待遷移的表數量需要符合Tablestore執行個體的限制(不超過64個),否則遷移任務會報錯。若您有超過64個表的遷移需求,請聯絡Tablestore的技術支援人員,提升目標Tablestore執行個體的表數量限制。

  • 待遷移的表或列名稱符合Tablestore執行個體的命名規範:

    • 表或列的名稱由大小寫字母、數字或底線(_)組成,且只能以字母或底線開頭。

    • 表或列的名稱長度為1~255個字元。

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

    說明

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

費用說明

遷移類型

鏈路配置費用

公網流量費用

結構遷移和全量資料移轉

不收費。

本樣本不收費。

增量資料移轉

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

支援增量遷移的SQL操作

操作類型

SQL動作陳述式

DML

INSERT、UPDATE、DELETE

資料庫帳號的許可權要求

資料庫

庫表結構遷移

全量遷移

增量遷移

PolarDB-X 2.0

SELECT許可權

SELECT許可權

REPLICATION SLAVE、REPLICATION CLIENT及待遷移對象的SELECT許可權。

資料庫帳號建立及授權方法:

PolarDB-X 2.0執行個體,請參見管理資料庫帳號資料同步過程中的帳號許可權問題

操作步驟

  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-X 2.0

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇源PolarDB-X 2.0執行個體所屬地區。

    是否跨阿里雲帳號

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

    執行個體ID

    選擇源PolarDB-X 2.0執行個體ID。

    資料庫帳號

    填入源PolarDB-X 2.0執行個體的資料庫帳號,許可權要求請參見資料庫帳號的許可權要求

    資料庫密碼

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

    目標庫資訊

    選擇已有串連資訊

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

      說明

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

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

    資料庫類型

    選擇Tablestore

    接入方式

    選擇雲執行個體

    執行個體地區

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

    執行個體ID

    選擇目標Tablestore執行個體的名稱。

    主帳號AccessKeyId

    填入用於標識使用者身份的Tablestore執行個體所屬阿里雲帳號(主帳號)的AccessKey ID。

    重要

    若您填入RAM使用者的AccessKey ID,則可能會導致任務因許可權不足而失敗。

    主帳號AccessKeySecret

    填入用於驗證使用者身份的Tablestore執行個體所屬阿里雲帳號(主帳號)的AccessKey Secret。

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

    說明

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

  5. 配置任務對象。

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

      配置

      說明

      遷移類型

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

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

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

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

      目標已存在表的處理模式

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

        說明

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

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

        警告

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

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

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

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

        • 表結構不一致的情況下,可能導致只能遷移部分列的資料或遷移失敗,請謹慎操作。

      同步操作類型

      根據業務選中需要遷移的操作類型,預設情況下都處於選中狀態。

      髒資料處理策略

      選擇資料寫入錯誤時的處理策略,取值為:

      • 跳過

      • 阻塞

      數據寫入模式

      選擇資料寫入的模式,取值為:

      • 行覆蓋:使用UpdateRowChange會做行層級覆蓋。

      • 行更新:使用PutRowChange會做行層級更新。

      批量寫入方式

      批量寫入調用介面,取值為:

      • BulkImportRequest:離線寫入。

      • BatchWriteRowRequest:批量寫入。

      說明

      建議選擇BulkImportRequest,讀寫效率更高,Tablestore執行個體計費便宜。

      更多設定

      您可以根據實際業務需求,單擊更多設定配置以下參數:

      • 隊列大小:Tablestore執行個體資料寫入進程的隊列長度。

      • 線程數:Tablestore執行個體資料寫入進程的回調處理線程數。

      • 並發數:Tablestore執行個體的並發要求節流數。

      • 分桶數:增量資料按序寫入時的分桶並發數,適當調大可提升並發寫入能力。

        說明

        分桶數需小於或等於並發數

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

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

      源庫對象

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

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

      • 只支援遷移單庫中的表,即只能選擇一個庫,或者選擇同一個庫裡的多個表。

      已選擇對象

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

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

      說明
      • 不支援庫名映射,僅當遷移對象選擇的粒度為表時,支援對錶名和列名使用映射功能。如果使用了映射功能,可能會導致依賴這個對象的其他對象遷移失敗。

      • 在使用列名映射功能時,您可以修改原表在目標Tablestore執行個體中對應列的類型。

      • 如需設定WHERE條件過濾資料,請在已選擇對象中右擊待遷移的表,在彈出的對話方塊中設定過濾條件。設定方法請參見設定過濾條件

    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),以緩解目標庫的壓力。

      說明
      • 僅當遷移類型選擇了增量遷移,才有此配置項。

      • 您也可以在遷移執行個體運行後,調整增量遷移的速率

      是否去除正反向任務的心跳錶sql

      根據業務需求選擇是否在DTS執行個體運行時,在源庫中寫入心跳SQL資訊。

      • :不在源庫中寫入心跳SQL資訊,DTS執行個體可能會顯示有延遲。

      • :在源庫中寫入心跳SQL資訊,可能會影響源庫的物理備份和複製等功能。

      環境標籤

      您可以根據實際情況,選擇用於標識執行個體的環境標籤。本樣本無需選擇。

      配置ETL功能

      暫不支援ETL功能,請選擇為

      監控警示

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

      • 不設定:不設定警示。

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

    3. 單擊下一步配置庫表欄位,並單擊提醒對話方塊的確定按鈕。

      DTS預設會將原表的主鍵設定為主鍵列,您可以將定義狀態選擇為全部後進行修改。

      說明

      主鍵列可以選擇多個列,組成聯合主鍵。

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

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

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

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

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

    • 如果預檢查產生警告:

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

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

  7. 購買執行個體。

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

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

      類別

      參數

      說明

      資訊配置

      資源群組配置

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

      鏈路規格

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

    3. 配置完成後,閱讀並選中《資料轉送(隨用隨付)服務條款》

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

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

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

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