全部產品

Data Transmission Service：PolarDB PostgreSQL版遷移至RDS PostgreSQL

更新時間：Feb 11, 2025

本文介紹如何使用Data Transmission Service，將PolarDB PostgreSQL版遷移至RDS PostgreSQL。

前提條件

已建立源PolarDB PostgreSQL版資料庫叢集，詳情請參見建立PolarDB PostgreSQL版資料庫叢集。
已建立目標RDS PostgreSQL執行個體，詳情請參見建立RDS PostgreSQL執行個體。
已將源PolarDB PostgreSQL版執行個體的wal_level參數值設定為logical。設定方式，請參見設定叢集參數。
目標資料庫的儲存空間須大於來源資料庫佔用的儲存空間。

注意事項

說明

在庫表結構遷移過程中，DTS會將來源資料庫中的外鍵遷移到目標資料庫。
在全量遷移和增量遷移過程中，DTS會以Session層級暫時禁用約束檢查以及外鍵級聯操作。若任務運行時源庫存在串聯更新、刪除操作，可能會導致資料不一致。

類型	說明
源庫限制	PolarDB PostgreSQL版叢集中，待遷移的表需具備主鍵或非空唯一索引。若源庫有長事務，且執行個體包含增量遷移任務，則可能會導致源庫長事務提交前的預寫記錄檔WAL（Write-Ahead Logging）無法清理而堆積，從而造成源庫磁碟空間不足。為保障遷移任務的正常進行，避免主備切換導致的邏輯訂閱中斷，需要PolarDB PostgreSQL版引擎支援並開啟Logical Replication Slot Failover，設定方式，請參見邏輯複製槽容錯移轉（Logical Replication Slot Failover）。源庫的操作限制：在庫表結構遷移和全量遷移階段，請勿執行庫或表結構變更的DDL操作，否則資料移轉任務會失敗。若僅執行全量資料移轉，請勿向源執行個體中寫入新的資料，否則會導致源和目標資料不一致。為即時保持資料一致性，建議選擇結構遷移、全量資料移轉和增量資料移轉。由於源庫的邏輯訂閱本身存在使用限制，在包含增量任務的遷移執行個體運行期間，若源庫待遷移的單條資料在增量變更後超過256 MB，則可能會導致遷移執行個體運行失敗且無法恢複，您需要重新設定遷移執行個體。
其他限制	單個資料移轉任務只能遷移一個資料庫，如需遷移多個資料庫，您需要為每個資料庫配置資料移轉任務。不支援遷移包含跨Schema繼承關係的表。由於全量資料移轉會並發執行INSERT操作，導致目標資料庫的表產生片段，因此全量資料移轉完成後目標資料庫的表格儲存體空間會比源執行個體的表格儲存體空間大。 DTS會嘗試恢複七天之內遷移失敗的任務。因此業務切換至目標執行個體前，請務必結束或釋放該任務，或者將DTS訪問目標執行個體帳號的寫入權限用`revoke`命令回收掉。避免該任務被自動回復後，源端資料覆蓋目標執行個體的資料。 DTS的校正對象為資料內容，暫不支援Sequence等中繼資料的校正，您需要自行校正。增量資料移轉期間，DTS會在源庫中建立首碼為`dts_sync_`的replication slot用於複製資料。通過該replication slot，DTS可以擷取源庫15分鐘內的增量日誌。說明 DTS釋放執行個體後會主動刪除該replication slot，如果您在遷移期間修改了資料庫密碼，或者刪除了DTS的訪問IP白名單，則會導致該replication slot無法自動刪除，此時需要您在源庫手動刪除，避免其持續累積佔用磁碟空間導致源庫不可用。當釋放遷移任務或遷移失敗時，DTS會主動清理該replication slot；如果源庫發生了主備切換，則需要您登入備庫來手動清理。由於業務切換到目標端後，新寫入的Sequence不會按照源庫的Sequence最大值作為初始值去遞增，您需要在業務切換前，更新目標庫的Sequence值。更多資訊，請參見更新目標庫的Sequence值。 DTS會在源庫中建立以下暫存資料表，用於擷取增量資料的DDL、增量表的結構、心跳資訊等。在遷移期間，請勿刪除源庫中的暫存資料表，否則會導致DTS任務異常。暫存資料表會在DTS執行個體釋放後自動刪除。 `public.dts_pg_class`、`public.dts_pg_attribute`、`public.dts_pg_type`、`public.dts_pg_enum`、`public.dts_postgres_heartbeat`、`public.dts_ddl_command`、`public.dts_args_session`。若為全量遷移或增量遷移任務，且來源資料庫中要遷移的表包含外鍵、觸發器、事件觸發程序，如果目標庫帳號為高許可權帳號或者super許可權帳號，全量或增量遷移時DTS會以Session層級暫時將session_replication_role的參數值設定為replica；如果目標庫帳號沒有該許可權，您需要手動將目標資料庫中session_replication_role的參數值設定為replica。在此期間（全量遷移或增量遷移過程中session_replication_role的參數值為replica），若源庫存在串聯更新、刪除操作，則可能會導致資料不一致。在DTS遷移任務釋放後，您可以將session_replication_role的參數值改回origin。若執行個體運行失敗，DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中，可能會對該執行個體進行重啟、調整參數等操作。說明在調整參數時，僅會修改執行個體的參數，不會對資料庫中的參數進行修改。可能修改的參數，包括但不限於修改執行個體參數中的參數。

費用說明

遷移類型	鏈路配置費用	公網流量費用
結構遷移和全量資料移轉	不收費。	通過公網將資料移轉出阿里雲時將收費，詳情請參見計費概述。
增量資料移轉	收費，詳情請參見計費概述。	通過公網將資料移轉出阿里雲時將收費，詳情請參見計費概述。

遷移類型說明

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

支援遷移的對象

SCHEMA、TABLE
說明
包含PRIMARY KEY、UNIQUE KEY、FOREIGN KEY、DATATYPE（內建資料類型）和DEFAULT CONSTRAINT。
VIEW、PROCEDURE（PostgreSQL的版本需為11及以上）、FUNCTION、RULE、SEQUENCE、EXTENSION、TRIGGER、AGGREGATE、INDEX、OPERATOR、DOMAIN

支援增量遷移的SQL操作

操作類型	SQL動作陳述式
DML	INSERT、UPDATE、DELETE
DDL	僅2020年10月01日後建立的資料移轉任務，支援遷移DDL操作。重要 2023年05月12日前建立的資料移轉任務，需在配置遷移任務前，在源庫中建立觸發器和函數來捕獲DDL資訊，詳情請參見通過觸發器和函數實現PostgreSQL的DDL增量遷移。增量資料移轉階段不支援遷移bit類型的資料。來源資料庫帳號需為高許可權帳號時，遷移任務支援如下DDL： CREATE TABLE、DROP TABLE ALTER TABLE（包括RENAME TABLE、ADD COLUMN、ADD COLUMN DEFAULT、ALTER COLUMN TYPE、DROP COLUMN、ADD CONSTRAINT、ADD CONSTRAINT CHECK、ALTER COLUMN DROP DEFAULT） TRUNCATE TABLE（源庫PostgreSQL為PostgreSQL 11及以上版本） CREATE INDEX ON TABLE 重要不支援遷移DDL中包含的附加資訊，如CASCADE或RESTRICT等。不支援遷移使用`SET session_replication_role = replica`命令的會話中的DDL。不支援遷移通過調用FUNCTION等方式執行的DDL。若源庫單次提交的多條SQL中同時包含DML和DDL，則該DDL不會被遷移。若源庫單次提交的多條SQL中包含非遷移對象的DDL，則該DDL不會被遷移。

資料庫帳號的許可權要求

資料庫	結構遷移	全量遷移	增量遷移	帳號建立及授權方法
PolarDB PostgreSQL版	高許可權帳號			建立資料庫帳號
RDS PostgreSQL	遷移對象的CREATE、USAGE許可權	Schema的owner許可權	Schema的owner許可權	建立帳號

操作步驟

進入目標地區的遷移工作清單頁面（二選一）。
通過DTS控制台進入
1. 登入Data Transmission Service控制台。
2. 在左側導覽列，單擊資料移轉。
3. 在頁面左上方，選擇遷移執行個體所屬地區。
通過DMS控制台進入
說明
實際操作可能會因DMS的模式和布局不同，而有所差異。更多資訊。請參見極簡模式控制台和自訂DMS介面布局與樣式。
1. 登入Data Management服務。
2. 在頂部功能表列中，選擇整合與開發 > 資料轉送（DTS） > 資料移轉。
3. 在遷移任務右側，選擇遷移執行個體所屬地區。
單擊創建任務，進入任務配置頁面。
可選：在頁面右上方，單擊試用新版配置頁。
說明
- 若您已進入新版配置頁（頁面右上方的按鈕為返回舊版配置頁），則無需執行此操作。
- 新版配置頁和舊版配置頁部分參數有差異，建議使用新版配置頁。

配置源庫及目標庫資訊。

類別	配置	說明
無	任務名稱	DTS會自動產生一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便於後續識別。
源庫資訊	資料庫類型	選擇PolarDB for PostgreSQL。
	接入方式	選擇雲執行個體。
	執行個體地區	選擇PolarDB PostgreSQL版叢集所屬地區。
	是否跨阿里雲帳號	本樣本為同一阿里雲帳號間遷移，選擇不跨帳號。
	執行個體ID	選擇目標PolarDB PostgreSQL版叢集ID。
	資料庫名稱	填入PolarDB PostgreSQL版資料庫的名稱。
	資料庫帳號	填入PolarDB PostgreSQL版的資料庫帳號。
	資料庫密碼	填入該資料庫帳號對應的密碼。
目標庫資訊	資料庫類型	選擇PostgreSQL。
	接入方式	選擇雲執行個體。
	執行個體地區	選擇目標RDS PostgreSQL執行個體所屬地區。
	執行個體ID	選擇目標RDS PostgreSQL執行個體ID。
	資料庫名稱	填入目標RDS PostgreSQL執行個體中遷移對象所屬資料庫的名稱。
	資料庫帳號	填入目標RDS PostgreSQL執行個體的資料庫帳號。
	資料庫密碼	填入該資料庫帳號對應的密碼。
	串連方式	請根據實際情況選擇，本樣本選擇非加密串連。若您需要SSL加密的方式串連資料庫，請選擇SSL安全連線，並根據實際情況上傳CA 憑證、客戶端認證、客戶端認證私密金鑰，輸入客戶端認證私密金鑰密碼。說明若自建PostgreSQL資料庫選擇了SSL安全連線，則必須上傳CA 憑證。若您需要使用用戶端認證，則需要同時上傳客戶端認證和客戶端認證私密金鑰，並輸入客戶端認證私密金鑰密碼。 RDS PostgreSQL執行個體的SSL加密功能，請參見SSL鏈路加密。

配置完成後，在頁面下方單擊測試連接以進行下一步。
說明
- 請確保DTS服務的IP位址區段能夠被自動或手動添加至源庫和目標庫的安全設定中，以允許DTS伺服器的訪問。更多資訊，請參見添加DTS伺服器的IP位址區段。
- 若源庫或目標庫為自建資料庫（接入方式不是雲執行個體），則還需要在彈出的DTS伺服器訪問授權對話方塊單擊測試連接。

配置任務對象。

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

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

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

配置	說明
選擇調度該任務的專屬叢集	DTS預設將任務調度到共用叢集上，您無需選擇。若您希望任務更加穩定，可以購買專屬叢集來運行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），以緩解目標庫的壓力。說明僅當遷移類型選擇了增量遷移時才可以配置。
環境標籤	您可以根據實際情況，選擇用於標識執行個體的環境標籤。本樣本無需選擇。
配置ETL功能	選擇是否配置ETL功能。關於ETL的更多資訊，請參見什麼是ETL。是：配置ETL功能，並在文字框中填寫資料處理語句，詳情請參見在DTS遷移或同步任務中配置ETL。否：不配置ETL功能。
監控警示	是否設定警示，當遷移失敗或延遲超過閾值後，將通知警示連絡人。不設定：不設定警示。設定：設定警示，您還需要設定警示閾值和警示通知。更多資訊，請參見在配置任務過程中配置監控警示。

單擊下一步資料校正，進行資料校正任務配置。
若您需要使用資料校正功能，配置方法請參見配置資料校正。

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

購買執行個體。

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

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

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

配置完成後，閱讀並選中《資料轉送（隨用隨付）服務條款》。
單擊購買並啟動，並在彈出的確認對話方塊，單擊確定。
您可在資料移轉介面查看具體進度。