將PolarDB-X 2.0的資料移轉到SelectDB - Data Transmission Service

本文為您介紹如何使用Data Transmission Service將PolarDB-X 2.0執行個體的資料移轉至雲資料庫SelectDB版執行個體。

前提條件

已建立源PolarDB-X 2.0執行個體和目標雲資料庫SelectDB版執行個體。

注意事項

類型	說明
源庫限制	頻寬要求：源庫所屬的伺服器需具備足夠出口頻寬（大於等於100 Mb/s），否則將影響資料移轉速率。源庫暫不支援企業版的PolarDB-X 2.0唯讀執行個體。遷移對象要求：不支援遷移表名中含大寫字母的表。不支援遷移INDEX、PARTITION、VIEW、PROCEDURE、FUNCTION、TRIGGER、FK。不支援遷移表組（TABLEGROUP）和包含Locality屬性的庫或表。不支援遷移名稱為保留字（如`select`等）的表。待遷移的表需具備主鍵或唯一約束，且欄位具有唯一性，否則可能會導致目標資料庫中出現重複資料。若遷移對象為表層級，且需進行編輯（如表列名映射），則單次遷移任務僅支援遷移至多1000張表。當超出數量限制，任務提交後會顯示請求報錯，此時建議您拆分待遷移的表，分批配置多個任務，或者配置整庫的遷移任務。 PolarDB-X 2.0執行個體預設已開啟Binlog，若您需要遷移增量資料，則需確保binlog_row_image的參數為full。否則預檢查階段提示報錯，且無法成功啟動資料移轉任務。更多資訊，請參見參數設定。源庫的操作限制：在庫表結構遷移和全量遷移階段，請勿執行庫或表結構變更的DDL操作，否則資料移轉任務會失敗。如僅執行全量資料移轉，請勿向源執行個體中寫入新的資料，否則會導致源和目標資料不一致。為即時保持資料一致性，建議選擇結構遷移、全量資料移轉和增量資料移轉。若PolarDB-X 2.0執行個體的網路資訊發生變更，遷移執行個體可能會在一段時間內出現延遲。
其他限制	DTS會在源庫定時嘗試執行CREATE DATABASE IF NOT EXISTS `test`命令建立`test`庫，並寫入心跳資料以推進Binlog位點。若在配置遷移執行個體時，是否去除正反向任務的心跳錶sql選擇為是（或者遷移執行個體使用的源庫帳號沒有建庫的許可權），且源庫長時間未執行DML操作，則可能會導致延遲資訊不準確。說明若遷移執行個體顯示的延遲時間過大，您可以在源庫執行一次DML操作來更新延遲資訊。目前只支援將資料移轉到SelectDB執行個體的Unique或Duplicate引擎表。目標表為Unique引擎表若目標表為Unique引擎表，請確保目標表中的所有唯一鍵均存在於源表中且在遷移對象中，否則可能會導致資料不一致。目標表為Duplicate引擎表若目標表為Duplicate引擎表，以下情況均可能會導致目標庫中出現重複資料，您可以自行根據附加列（_is_deleted、_version和_record_id）進行去重操作：遷移執行個體發生過重試操作。遷移執行個體執行過重啟操作。遷移執行個體開始運行後，待遷移的同一條資料執行過兩次或更多次DML操作。說明當目標表為Duplicate引擎表時，DTS會將UPDATE或DELETE語句轉換為INSERT語句。在已選擇對象框中進行參數設定時，當前僅支援設定`bucket_count`參數（分桶數量）。說明 `bucket_count`的參數值僅支援設定為正整數，預設值為auto。在資料移轉期間，請勿在目標SelectDB執行個體中建立叢集，否則會導致任務失敗。您可以嘗試通過重新啟動遷移執行個體，來恢複失敗的任務。由於SelectDB執行個體僅支援以字母開頭的庫名和表名，如果待遷移的庫名或表名不是以字母開頭，則需要使用映射功能進行修改。若待遷移對象（庫、表、列）的名稱包含中文，則需要使用映射功能進行修改（例如將其修改為英文），否則可能會導致任務失敗。不支援遷移一次性修改多個列的DDL操作，以及對同一張表進行連續修改的DDL操作。在資料移轉期間，請勿在SelectDB資料庫中增加BE（Backend）節點，否則會導致任務失敗。您可以嘗試通過重新啟動遷移執行個體，來恢複失敗的任務。在多表合并（將源端多張表的資料移轉到目標端的同一張表）情境中，請確保源端多張表的表結構一致，否則可能會導致資料不一致或任務失敗。在PolarDB-X 2.0執行個體中，`VARCHAR(M)`類型的M表示字元長度；在SelectDB中，`VARCHAR(N)`類型的N表示位元組長度。若您不使用DTS提供的庫表結構遷移功能，建議您將SelectDB中VARCHAR類型欄位的長度設定為PolarDB-X 2.0執行個體中VARCHAR欄位長度的四倍。在源端使用DMS或gh-ost工具執行Online DDL變更時，DTS僅會將原始DDL遷移到目標端。在此情境中，DTS無需遷移大量的暫存資料表資料，但可能會導致目標端鎖表。說明不支援遷移源端使用pt-online-schema-change等類似工具執行的Online DDL變更。若源端有相關變更，則可能會導致目標端資料丟失或遷移執行個體運行失敗。在全量資料移轉時，DTS將會佔用源和目標庫一定的讀寫資源，可能會導致資料庫的負載上升。因此建議在執行資料移轉前評估源庫和目標庫的效能，並在業務低峰期執行資料移轉（例如源庫和目標庫的CPU負載在30%以下）。由於全量資料移轉會並發執行INSERT操作，導致目標資料庫的表產生片段，因此全量遷移完成後目標庫的表格儲存體空間會大於源庫的表格儲存體空間。在遷移執行個體運行期間，若存在除DTS外的其他資料來源向目標庫寫入資料，則可能會導致源庫與目標庫的資料不一致，甚至會導致遷移執行個體運行失敗。若執行個體運行失敗，DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中，可能會對該執行個體進行重啟、調整參數等操作。說明在調整參數時，僅會修改DTS執行個體的參數，不會對資料庫中的參數進行修改。可能修改的參數，包括但不限於修改執行個體參數中的參數。

費用說明

遷移類型	鏈路配置費用	公網流量費用
結構遷移和全量資料移轉	不收費。	本樣本不收費。說明當目標庫的接入方式為公網IP時收取公網流量費用，詳情請參見計費概述。
增量資料移轉	收費，詳情請參見計費概述。	本樣本不收費。說明當目標庫的接入方式為公網IP時收取公網流量費用，詳情請參見計費概述。

支援增量遷移的SQL

操作類型	SQL動作陳述式
DML	INSERT、UPDATE、DELETE
DDL	ADD COLUMN MODIFY COLUMN CHANGE COLUMN DROP COLUMN、DROP TABLE TRUNCATE TABLE RENAME TABLE 重要 RENAME TABLE操作可能導致遷移資料不一致。例如遷移對象只包含某個表，如果遷移過程中源執行個體對該表執行了重新命名操作，那麼該表的資料將不會遷移到目標庫。為避免該問題，您可以在資料移轉配置時將該表所屬的整個資料庫作為遷移對象，且確保RENAME TABLE操作前後的表所屬的資料庫均在遷移對象中。

資料庫帳號的許可權要求

資料庫	庫表結構遷移	全量遷移	增量遷移
源PolarDB-X 2.0	SELECT許可權。	SELECT許可權。	REPLICATION SLAVE、REPLICATION CLIENT及待遷移對象的SELECT許可權。
目標SelectDB	叢集存取權限（Usage_priv）和資料庫的讀寫權限（Select_priv、Load_priv、Alter_priv、Create_priv、Drop_priv）。

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

PolarDB-X 2.0執行個體，請參見管理資料庫帳號和資料同步過程中的帳號許可權問題。
SelectDB執行個體，請參見叢集許可權管理和基礎許可權管理

操作步驟

進入目標地區的遷移工作清單頁面（二選一）。
通過DTS控制台進入
1. 登入Data Transmission Service控制台。
2. 在左側導覽列，單擊資料移轉。
3. 在頁面左上方，選擇遷移執行個體所屬地區。
通過DMS控制台進入
說明
實際操作可能會因DMS的模式和布局不同，而有所差異。更多資訊。請參見極簡模式控制台和自訂DMS介面布局與樣式。
1. 登入Data Management服務。
2. 在頂部功能表列中，選擇Data + AI > 資料轉送（DTS） > 資料移轉。
3. 在遷移任務右側，選擇遷移執行個體所屬地區。
單擊創建任務，進入任務配置頁面。

配置源庫及目標庫資訊。

類別	配置	說明
無	任務名稱	DTS會自動產生一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便於後續識別。
源庫資訊	選擇已有串連資訊	若您需要使用已錄入系統（建立或儲存）的資料庫執行個體，請在下拉式清單中選擇所需的資料庫執行個體，下方的資料庫資訊將自動進行配置。說明 DMS控制台的配置項為選擇DMS資料庫執行個體。若您未將資料庫執行個體錄入到系統，或無需使用已錄入系統的資料庫執行個體，則需要手動設定下方的資料庫資訊。
	資料庫類型	選擇PolarDB-X 2.0。
	接入方式	選擇雲執行個體。
	執行個體地區	選擇源PolarDB-X 2.0執行個體所屬的地區。
	是否跨阿里雲帳號	本樣本使用當前阿里雲帳號下的資料庫執行個體，需選擇不跨帳號。
	執行個體ID	選擇源PolarDB-X 2.0執行個體的ID。
	資料庫帳號	填入源PolarDB-X 2.0執行個體的資料庫帳號。許可權要求，請參見資料庫帳號的許可權要求。
	資料庫密碼	填入該資料庫帳號對應的密碼。
目標庫資訊	選擇已有串連資訊	若您需要使用已錄入系統（建立或儲存）的資料庫執行個體，請在下拉式清單中選擇所需的資料庫執行個體，下方的資料庫資訊將自動進行配置。說明 DMS控制台的配置項為選擇DMS資料庫執行個體。若您未將資料庫執行個體錄入到系統，或無需使用已錄入系統的資料庫執行個體，則需要手動設定下方的資料庫資訊。
	資料庫類型	選擇SelectDB。
	接入方式	選擇雲執行個體。
	執行個體地區	選擇目標SelectDB執行個體所屬地區。
	是否跨阿里雲帳號	本樣本使用當前阿里雲帳號下的資料庫執行個體，需選擇不跨帳號。
	執行個體ID	選擇目標SelectDB執行個體的ID。
	資料庫帳號	填入目標SelectDB執行個體的資料庫帳號。許可權要求，請參見資料庫帳號的許可權要求。
	資料庫密碼	填入該資料庫帳號對應的密碼。

配置完成後，在頁面下方單擊測試連接以進行下一步。
說明
請確保DTS服務的IP位址區段能夠被自動或手動添加至源庫和目標庫的安全設定中，以允許DTS伺服器的訪問。更多資訊，請參見添加DTS伺服器IP地址白名單。

配置任務對象。

在對象配置頁面，配置待遷移的對象。

配置	說明
遷移類型	如果只需要進行全量資料移轉，請同時選中庫表結構遷移和全量遷移。如果需要進行不停機遷移，請同時選中庫表結構遷移、全量遷移和增量遷移。 PolarDB-X 2.0執行個體的資料移轉到SelectDB會進行類型轉換，若您未勾選庫表結構遷移，則需要提前在目標SelectDB中建立好相應結構的Unique或Duplicate模型表。更多資訊，請參見資料類型映射關係、附加列資訊和資料模型。若您未勾選增量遷移，為保障資料一致性，資料移轉期間請勿在源執行個體中寫入新的資料。
目標已存在表的處理模式	預檢查並報錯攔截：檢查目標資料庫中是否有同名的表。如果目標資料庫中沒有同名的表，則通過該檢查專案；如果目標資料庫中有同名的表，則在預檢查階段提示錯誤，資料移轉任務不會被啟動。說明如果目標庫中同名的表不方便刪除或重新命名，您可以更改該表在目標庫中的名稱，請參見庫表列名映射。忽略報錯並繼續執行：跳過目標資料庫中是否有同名表的檢查項。警告選擇為忽略報錯並繼續執行，可能導致資料不一致，給業務帶來風險，例如：表結構一致的情況下，在目標庫遇到與源庫主鍵的值相同的記錄，DTS不會保留目的地組群中的該條記錄，即源庫中的該條記錄會覆蓋至目標資料庫中。表結構不一致的情況下，可能導致只能遷移部分列的資料或遷移失敗，請謹慎操作。
目標庫對象名稱大小寫策略	您可以配置目標執行個體中遷移對象的庫名、表名和列名的英文大小寫策略。預設情況下選擇DTS預設策略，您也可以選擇與源庫、目標庫預設策略保持一致。更多資訊，請參見目標庫對象名稱大小寫策略。
源庫對象	在源庫對象框中單擊待遷移的對象，然後單擊將其移動到已選擇對象框。說明遷移對象選擇的粒度為庫或表。
已選擇對象	如需更改待遷移對象在目標執行個體中的名稱，請右擊已選擇對象中的遷移對象，設定方式，請參見庫表列名映射。若遷移類型選中了庫表結構遷移、待遷移對象選擇的粒度為表，且需設定分桶數量（`bucket_count`參數），請右擊已選擇對象中遷移的表，在參數設定地區將開啟參數設定選擇為是，並根據實際情況設定參數值，然後單擊確定。說明如需按庫或表層級選擇增量遷移的SQL操作，請在已選擇對象中右擊待遷移對象，並在彈出的對話方塊中選擇所需遷移的SQL操作。如需設定WHERE條件過濾資料，請在已選擇對象中右擊待遷移的表，在彈出的對話方塊中設定過濾條件。設定方法請參見設定過濾條件。如果使用了對象名映射功能，可能會導致依賴這個對象的其他對象遷移失敗。

單擊下一步高級配置，進行進階參數配置。

配置	說明
選擇調度該任務的專屬叢集	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功能。關於ETL的更多資訊，請參見什麼是ETL。是：配置ETL功能，並在文字框中填寫資料處理語句，詳情請參見在DTS遷移或同步任務中配置ETL。否：不配置ETL功能。
監控警示	根據業務需求選擇是否設定警示並接收警示通知。不設定：不設定警示。設定：設定警示。您還需要設定警示閾值和警示通知，當遷移失敗或延遲超過閾值後，系統將進行警示通知。

可選：上述配置完成後，單擊下一步配置庫表欄位，設定待遷移的表在目標庫中的主鍵列、分布鍵和引擎選擇資訊。
說明
- 配置任務對象時遷移類型勾選了庫表結構遷移時才會有本步驟，您可以將定義狀態選擇為全部後進行修改。
- 主鍵列可以是選擇多個列組成聯合主鍵，且需要從主鍵列中選擇1個或者多個列作為分布鍵。
- 既無主鍵也無唯一約束的表，引擎選擇需選擇為duplicate，否則可能會導致執行個體失敗或資料丟失。

儲存任務並進行預檢查。
- 若您需要查看調用API介面配置該執行個體時的參數資訊，請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上，然後單擊氣泡中的預覽OpenAPI參數。
- 若您無需查看或已完成查看API參數，請單擊頁面下方的下一步儲存任務並預檢查。
說明
- 在遷移任務正式啟動之前，會先進行預檢查。只有預檢查通過後，才能成功啟動遷移任務。
- 如果預檢查失敗，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。
- 如果預檢查產生警告：
  對於不可以忽略的檢查項，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。
  對於可以忽略無需修複的檢查項，您可以依次單擊點擊確認警示詳情、確認屏蔽、確定、重新進行預檢查，跳過警示檢查項重新進行預檢查。如果選擇屏蔽警示檢查項，可能會導致資料不一致等問題，給業務帶來風險。

購買執行個體。

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

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

類別	參數	說明
資訊配置	資源群組配置	選擇執行個體所屬的資源群組，預設為default resource group。更多資訊，請參見什麼是資源管理。
資訊配置	鏈路規格	DTS為您提供了不同效能的遷移規格，遷移鏈路規格的不同會影響遷移速率，您可以根據業務情境進行選擇。更多資訊，請參見資料移轉鏈路規格說明。

配置完成後，閱讀並選中《資料轉送（隨用隨付）服務條款》。
單擊購買並啟動，並在彈出的確認對話方塊，單擊確定。
您可以在遷移任務列表頁面，查看遷移執行個體的具體進度。
說明
- 若遷移執行個體不包含增量遷移任務，則遷移執行個體會自動結束。遷移執行個體自動結束後，運行狀態為已完成。
- 若遷移執行個體包含增量遷移任務，則遷移執行個體不會自動結束，增量遷移任務會持續進行。在增量遷移任務正常運行期間，遷移執行個體的運行狀態為運行中。

資料類型映射關係

類別	PolarDB-X 2.0執行個體的資料類型	SelectDB的資料類型
Numeric	TINYINT	TINYINT
	TINYINT UNSIGNED	SMALLINT
	SMALLINT	SMALLINT
	SMALLINT UNSIGNED	INT
	MEDIUMINT	INT
	MEDIUMINT UNSIGNED	BIGINT
	INT	INT
	INT UNSIGNED	BIGINT
	BIGINT	BIGINT
	BIGINT UNSIGNED	LARGEINT
	BIT(M)	INT
	Decimal	Decimal 說明不支援zerofill。
	Numeric	Decimal
	Float	Float
	Double	DOUBLE
	BOOL BOOLEAN	BOOLEAN
DATE AND TIME	DATE	DATEV2
	DATETIME[(fsp)]	DATETIMEV2
	Timestamp[(fsp)]	DATETIMEV2
	Time[(fsp)]	VARCHAR
	YEAR[(4)]	INT
STRING	CHAR VARCHAR	VARCHAR 重要為避免資料丟失，CHAR和VARCHAR(n)類型的資料移轉到SelectDB後會轉換為VARCHAR(4*n)。若未指定資料長度，則採用SelectDB的預設值VARCHAR(65533)。若資料長度超過65533，則遷移到SelectDB後會轉換為STRING。
	BINARY VARBINARY	STRING
	TINYTEXT TEXT MEDIUMTEXT LONGTEXT	STRING
	TINYBLOB BLOB MEDIUMBOLB LONGBLOB	STRING
	ENUM	STRING
	SET	STRING
	JSON	STRING

附加列資訊

說明

在目標Duplicate模型表中，DTS自動添加或需您手動添加的附加列如下表所示。

名稱	資料類型	預設值	說明
_is_deleted	Int	0	資料是否被刪除。 Insert：記錄為0。 Update：記錄為0。 Delete：記錄為1。
_version	Bigint	0	全量遷移的資料：記錄為0。增量遷移的資料：源庫Binlog中對應的時間戳記（秒級）。
_record_id	Bigint	0	全量遷移資料：記錄為0。增量遷移資料：增量日誌的記錄ID，為該日誌的唯一標識。說明 ID的值唯一且遞增。

前提條件

注意事項

目標表為Unique引擎表

目標表為Duplicate引擎表