全部產品
Search
文件中心

Data Transmission Service:自建TiDB遷移至PolarDB MySQL版

更新時間:Oct 25, 2024

本文介紹如何使用Data Transmission Service,將TiDB資料庫的資料移轉至PolarDB MySQL版叢集。

前提條件

準備工作(可選)

TiDB的增量資料變更有如下兩種採集方式,請根據實際情況選擇。

使用TiDB Binlog

說明

為減少網路延遲對資料移轉的影響,Pump組件、Drainer組件和Kafka叢集所部署的伺服器需要與源庫所屬的伺服器在同一內網中。

  1. 準備Kafka叢集(二選一)。

    • 部署自建Kafka叢集,詳情請參見Apache Kafka官網

      警告

      為保障Kafka叢集可以正常接收TiDB資料庫產生的較大的Binlog資料,請適當將Broker組件中的message.max.bytesreplica.fetch.max.bytes參數以及Consumer組件中的fetch.message.max.bytes參數對應的值調大,詳情請參見Kafka配置說明

    • 使用阿里雲訊息佇列Kafka版,詳情請參見快速入門

      說明

      為保障正常通訊和減少網路延遲對增量資料移轉的影響,部署阿里雲訊息佇列Kafka執行個體時,需要配置和源程式庫伺服器相同的專用網路。

  2. 在自建Kafka叢集或阿里雲訊息佇列Kafka執行個體中建立Topic。

    重要

    建立的Topic應當只包含一個分區,以確保增量資料可以被複製到ID為0的分區。

  3. 部署Pump和Drainer組件,詳情請參見TiDB Binlog叢集部署

  4. 修改Drainer組件的設定檔,設定輸出為Kafka,詳情請參見Kafka自訂開發

    說明

    請確保TiDB資料庫所在的伺服器能夠正常串連到Kafka叢集。

  5. 將DTS伺服器的IP位址區段加入至TiDB資料庫的白名單安全設定中,具體IP位址區段資訊請參見添加DTS伺服器的IP位址區段

使用TiDB CDC

  1. 準備Kafka叢集(二選一)。

    • 部署自建Kafka叢集,詳情請參見Apache Kafka官網

      警告

      為保障Kafka叢集可以正常接收TiDB資料庫產生的較大的Binlog資料,請適當將Broker組件中的message.max.bytesreplica.fetch.max.bytes參數以及Consumer組件中的fetch.message.max.bytes參數對應的值調大,詳情請參見Kafka配置說明

    • 使用阿里雲訊息佇列Kafka版,詳情請參見快速入門

      說明

      為保障正常通訊和減少網路延遲對增量資料移轉的影響,部署阿里雲訊息佇列Kafka執行個體時,需要配置和源程式庫伺服器相同的專用網路。

  2. 在自建Kafka叢集或阿里雲訊息佇列Kafka執行個體中建立Topic。

    重要

    建立的Topic應當只包含一個分區,以確保增量資料可以被複製到ID為0的分區。

  3. 安裝TiCDC組件,詳情請參見部署TiCDC

    說明

    建議使用TiUP在原有TiDB叢集上新增或擴容TiCDC組件。

  4. 將增量資料複製到Kafka,詳情請參見同步資料到Kafka

    說明
    • 請確保TiDB資料庫所在的伺服器能夠正常串連到Kafka叢集。

    • 建議第一行命令使用tiup cdc cli changefeed create \

注意事項

類型

說明

源庫限制

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

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

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

  • 若您需要遷移增量資料,則需要部署Kafka叢集以及TiDB資料庫的相關組件,以採集TiDB資料庫的增量變更資料。

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

其他限制

  • 在增量資料移轉過程中,DTS僅支援從目標Topic中ID為0的分區擷取資料。

  • 若任務包含增量資料移轉,在任務建立成功後,請務必及時在源端執行相應的變更或插入測試資料,以更新執行個體的位點資訊。否則,執行個體可能會因為延遲過大而失敗。

  • 在進行全量資料移轉時,DTS將會佔用源和目標庫一定的讀寫資源,可能會導致資料庫的負載上升。因此建議在執行資料移轉前評估源庫和目標庫的效能,並在業務低峰期執行資料移轉(例如源庫和目標庫的CPU負載在30%以下)。

  • 由於全量資料移轉會並發執行INSERT操作,導致目標資料庫的表產生片段,因此全量遷移完成後目標資料庫的表格儲存體空間會比源執行個體的表格儲存體空間大。

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

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

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

  • 若目標庫的DDL寫入失敗,DTS任務會繼續運行,您需要在任務日誌中查看執行失敗的DDL。查看任務日誌的方法,請參見查詢任務日誌

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

    說明

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

費用說明

遷移類型

鏈路配置費用

公網流量費用

結構遷移和全量資料移轉

不收費。

通過公網將資料移轉出阿里雲時將收費,詳情請參見計費概述

增量資料移轉

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

支援增量遷移的SQL操作

操作類型

SQL動作陳述式

DML

INSERT、UPDATE、DELETE

DDL

CREATE TABLE、DROP TABLE、RENAME TABLE、TRUNCATE TABLE、ADD COLUMN、DROP COLUMN

資料庫帳號的許可權要求

資料庫

許可權要求

帳號建立及授權方法

TiDB資料庫

SHOW VIEW和待遷移對象的SELECT許可權

許可權管理

PolarDB MySQL版叢集

目標庫的讀寫權限

建立和管理資料庫帳號

操作步驟

  1. 進入遷移任務的列表頁面。

    1. 登入Data Management服務

    2. 在頂部功能表列中,單擊整合與開發

    3. 在左側導覽列,選擇資料轉送(DTS) > 資料移轉

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

    說明

    新版DTS遷移工作清單頁面,需要在頁面左上方選擇遷移執行個體所屬地區。

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

  4. 可選:在頁面右上方,單擊試用新版配置頁

    說明
    • 若您已進入新版配置頁(頁面右上方的按鈕為返回舊版配置頁),則無需執行此操作。

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

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

    類別

    配置

    說明

    任務名稱

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

    源庫資訊

    選擇DMS資料庫執行個體

    您可以按實際需求,選擇是否使用已有執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明

    資料庫類型

    選擇TiDB

    接入方式

    請根據TiDB資料庫的部署位置進行選擇,本樣本選擇ECS自建資料庫

    說明

    當自建資料庫為其他接入方式時,您還需要執行相應的準備工作,詳情請參見準備工作概覽

    執行個體地區

    選擇TiDB資料庫所屬的地區。

    ECS執行個體ID

    選擇TiDB資料庫所屬的ECS執行個體ID。

    連接埠

    填入TiDB資料庫的服務連接埠,預設為4000

    資料庫帳號

    填入TiDB資料庫的帳號,許可權要求請參見資料庫帳號的許可權要求

    資料庫密碼

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

    是否做增量遷移

    請根據需求選擇是否遷移TiDB資料庫的增量資料。

    說明

    若您需要遷移TiDB資料庫的增量資料,請選擇為,同時需要填寫Kafka叢集資訊。更多資訊,請參見Kafka叢集資訊

    目標庫資訊

    選擇DMS資料庫執行個體

    您可以按實際需求,選擇是否使用已有執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明

    資料庫類型

    選擇PolarDB for MySQL

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇目標PolarDB MySQL版叢集所屬地區。

    是否跨阿里雲帳號

    本樣本使用當前阿里雲帳號下的資料庫執行個體,需選擇不跨帳號

    PolarDB執行個體ID

    選擇目標PolarDB MySQL版叢集的ID。

    資料庫帳號

    填入目標PolarDB MySQL版叢集的資料庫帳號,許可權要求請參見資料庫帳號的許可權要求

    資料庫密碼

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

    串連方式

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

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

    如果源或目標資料庫是阿里雲資料庫執行個體(例如RDS MySQLApsaraDB for 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會保留目的地組群中的該條記錄,即源庫中的該條記錄不會遷移至目標資料庫中。

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

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

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

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

      源庫對象

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

      說明

      遷移對象選擇的粒度為庫或表。

      已選擇對象

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

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

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

      • 如果使用了對象名映射功能,可能會導致依賴這個對象的其他對象遷移失敗。

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

      配置

      說明

      選擇目標庫的引擎類型

      請根據實際情況選擇目標庫的引擎類型。

      • InnoDB:預設儲存引擎。

      • X-Engine:聯機交易處理OLTP(On-Line Transaction Processing)資料庫儲存引擎。

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

      在遷移任務啟動後,若源庫或目標庫串連失敗則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),以緩解目標庫的壓力。

      說明

      僅當遷移類型選擇了增量遷移時才可以配置。

      環境標籤

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

      配置ETL功能

      選擇是否配置ETL功能。關於ETL的更多資訊,請參見什麼是ETL

      監控警示

      是否設定警示,當遷移失敗或延遲超過閾值後,將通知警示連絡人。

    3. 單擊下一步資料校正,進行資料校正任務配置。

      若您需要使用資料校正功能,配置方法請參見配置資料校正

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

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

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

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

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

    • 如果預檢查產生警告:

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

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

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

  10. 購買執行個體。

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

      類別

      參數

      說明

      資訊配置

      資源群組配置

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

      鏈路規格

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

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

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

      您可在資料移轉介面查看具體進度。

Kafka叢集資訊

配置

說明

Kafka叢集類型

請根據Kafka叢集的部署位置進行選擇,本樣本選擇ECS自建資料庫

說明

若您選擇為專線/VPN網關/智能網關,還需要選擇已和源端資料庫聯通的VPC,並填寫網域名稱或IP地址

Kafka數據來源組件

請根據準備工作選擇使用TiDB的預設binlog格式使用TiDB CDC模式的Canal-JSON格式

ECS執行個體ID

選擇Kafka叢集所屬的ECS執行個體ID。

連接埠

填入Kafka叢集的服務連接埠。

Kafka叢集帳號

填入Kafka叢集的使用者名稱和密碼,若Kafka叢集未開啟驗證則無需填寫。

Kafka叢集密碼

Kafka版本

根據Kafka叢集的版本,選擇對應的版本資訊。

說明

若Kafka叢集的版本為1.0及以上版本,請選擇1.0

串連方式

根據業務及安全需求,選擇非加密串連SCRAM-SHA-256

Topic

選擇增量資料所在的Topic。