本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業務造成影響,請務必仔細閱讀。
通過使用數據傳輸服務DTS(Data Transmission Service),您可以實現自建PostgreSQL遷移至PolarDB PostgreSQL版(兼容Oracle)集群。
前提條件
已創建目標PolarDB PostgreSQL版(兼容Oracle)集群,詳情請參見創建PolarDB PostgreSQL版(兼容Oracle)集群。
說明源庫和目標庫支持的版本,請參見遷移方案概覽。
PolarDB PostgreSQL版(兼容Oracle)集群的存儲空間須大于自建PostgreSQL占用的存儲空間。
注意事項
在庫表結構遷移過程中,DTS會將源數據庫中的外鍵遷移到目標數據庫。
在全量遷移和增量遷移過程中,DTS會以Session級別暫時禁用約束檢查以及外鍵級聯操作。若任務運行時源庫存在級聯更新、刪除操作,可能會導致數據不一致。
類型 | 說明 |
源庫限制 |
|
其他限制 |
|
特殊情況 |
|
費用說明
遷移類型 | 鏈路配置費用 | 公網流量費用 |
結構遷移和全量數據遷移 | 不收費。 | 通過公網將數據遷移出阿里云時將收費,詳情請參見計費概述。 |
增量數據遷移 | 收費,詳情請參見計費概述。 |
遷移類型說明
庫表結構遷移
DTS將源庫中遷移對象的結構定義遷移到目標庫。
全量遷移
DTS將源庫中遷移對象的存量數據,全部遷移到目標庫中。
增量遷移
DTS在全量遷移的基礎上,將源庫的增量更新數據遷移到目標庫中。通過增量數據遷移可以實現在自建應用不停機的情況下,平滑地完成數據遷移。
支持增量遷移的SQL操作
操作類型 | SQL操作語句 |
DML | INSERT、UPDATE、DELETE |
DDL |
|
數據庫賬號的權限要求
數據庫 | 庫表結構遷移 | 全量遷移 | 增量遷移 |
自建PostgreSQL | pg_catalog的usage權限 | 遷移對象的select權限 | superuser |
PolarDB PostgreSQL版(兼容Oracle)集群 | 數據庫Owner權限。 重要 數據庫Owner在創建數據庫時已指定。 |
數據庫賬號創建及授權方法:
自建PostgreSQL數據庫請參見CREATE USER和GRANT語法。
PolarDB PostgreSQL版(兼容Oracle)集群請參見創建數據庫賬號。
準備工作
若您的源庫為Amazon RDS for PostgreSQL,準備工作請參見準備工作;若您的源庫為Amazon Aurora PostgreSQL,準備工作請參見準備工作一:調整Amazon的入站規則。
如下所示為Linux系統的操作步驟。
自建PostgreSQL(所有版本)需執行如下準備工作。
登錄自建PostgreSQL所屬的服務器。
執行如下命令,查詢數據庫已使用復制槽數量。
select count(1) from pg_replication_slots;
修改配置文件
postgresql.conf
,將配置文件中的wal_level
設置為logical
,并確保max_wal_senders
和max_replication_slots
的參數值,均大于數據庫復制槽已使用數與需要以該自建PostgreSQL為源創建的DTS實例數的總和。# - Settings - wal_level = logical # minimal, replica, or logical # (change requires restart) ...... # - Sending Server(s) - # Set these on the master and on any standby that will send replication data. max_wal_senders = 10 # max number of walsender processes # (change requires restart) #wal_keep_segments = 0 # in logfile segments, 16MB each; 0 disables #wal_sender_timeout = 60s # in milliseconds; 0 disables max_replication_slots = 10 # max number of replication slots # (change requires restart)
說明配置文件修改完成后,您需要重啟自建PostgreSQL使參數生效。
將DTS的IP地址加入至自建PostgreSQL的配置文件pg_hba.conf中。您只需添加目標數據庫所在區域對應的DTS IP地址段,詳情請參見添加DTS服務器的IP地址段。
說明配置文件修改完成后,您需要執行
SELECT pg_reload_conf();
命令或重啟自建PostgreSQL使參數生效。關于該配置文件的設置請參見pg_hba.conf文件。如果您已將信任地址配置為
0.0.0.0/0
(如下圖所示),可跳過本步驟。
根據待遷移對象所屬的數據庫和Schema信息,在目標數據庫實例中創建相應數據庫和Schema。
若自建PostgreSQL版本為9.4.8~10.0,則您還需執行如下準備工作。
下載PostgreSQL源碼并完成編譯安裝。
根據源庫自建PostgreSQL的版本,從PostgreSQL官網下載對應版本的源碼。
依次執行命令
sudo ./configure
、sudo make
、sudo make install
,配置、編譯并安裝源碼。重要編譯安裝PostgreSQL時,PostgreSQL的操作系統版本需與GCC(GNU編譯器套件)版本保持一致。
如執行
sudo ./configure
遇到報錯,您可以根據報錯提示調整命令。例如,報錯信息為readline library not found. Use --without-readline to disable readline support.
,則您可以調整命令為sudo ./configure --without-readline
.如您選擇其他方式安裝PostgreSQL,需要在系統版本以及GCC版本相同的測試環境下,編譯ali_decoding。
下載DTS提供的插件ali_decoding并完成編譯安裝。
下載ali_decoding。
將ali_decoding整個目錄拷貝至PostgreSQL(已完成編譯安裝)的contrib目錄中。
進入ali_decoding目錄,將Makefile文件的內容替換為如下:
# contrib/ali_decoding/Makefile MODULE_big = ali_decoding MODULES = ali_decoding OBJS = ali_decoding.o DATA = ali_decoding--0.0.1.sql ali_decoding--unpackaged--0.0.1.sql EXTENSION = ali_decoding NAME = ali_decoding #subdir = contrib/ali_decoding #top_builddir = ../.. #include $(top_builddir)/src/Makefile.global #include $(top_srcdir)/contrib/contrib-global.mk #PG_CONFIG = /usr/pgsql-9.6/bin/pg_config #pgsql_lib_dir := $(shell $(PG_CONFIG) --libdir) #PGXS := $(shell $(PG_CONFIG) --pgxs) #include $(PGXS) # 源碼安裝用以下 ifdef USE_PGXS PG_CONFIG = pg_config PGXS := $(shell $(PG_CONFIG) --pgxs) include $(PGXS) else subdir = contrib/ali_decoding top_builddir = ../.. include $(top_builddir)/src/Makefile.global include $(top_srcdir)/contrib/contrib-global.mk endif
進入ali_decoding目錄,依次執行命令
sudo make
、sudo make install
,編譯ali_decoding,并得到安裝ali_decoding所需的文件。將如下文件復制至指定位置。
根據待遷移對象所屬的數據庫和Schema信息,在目標數據庫實例中創建相應數據庫和Schema。
操作步驟
進入遷移任務的列表頁面。
登錄DMS數據管理服務。
在頂部菜單欄中,單擊集成與開發。
在左側導航欄,選擇 。
說明實際操作可能會因DMS的模式和布局不同,而有所差異。更多信息,請參見極簡模式控制臺和自定義DMS界面布局與樣式。
您也可以登錄新版DTS遷移任務的列表頁面。
在遷移任務右側,選擇遷移實例所屬地域。
說明新版DTS遷移任務列表頁面,需要在頁面左上角選擇遷移實例所屬地域。
單擊創建任務,配置源庫及目標庫信息。
警告選擇源和目標實例后,建議您仔細閱讀頁面上方顯示的使用限制,以成功創建并執行遷移任務。
類別
配置
說明
無
任務名稱
DTS會自動生成一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便于后續識別。
源庫信息
數據庫類型
選擇PostgreSQL。
接入方式
選擇通過專線/VPN網關/智能網關接入的自建數據庫。
說明當選擇為自建數據庫時,您還需要執行相應的準備工作,詳情請參見準備工作概覽。
實例地區
選擇自建PostgreSQL數據庫所屬地域。
是否跨阿里云賬號
本案例為同一阿里云賬號間遷移,選擇不跨賬號。
已和源端數據庫聯通的VPC
選擇自建PostgreSQL數據庫所屬的專有網絡ID。
IP地址
填入自建PostgreSQL數據庫的服務器IP地址。
端口
填入自建PostgreSQL數據庫的服務端口,默認為5432。
數據庫名稱
填入自建PostgreSQL數據庫中遷移對象所屬數據庫的名稱。
數據庫賬號
填入自建PostgreSQL的數據庫賬號,權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
連接方式
請根據實際情況選擇,本示例選擇非加密連接。
若您需要SSL加密的方式連接數據庫,請選擇SSL安全連接,并根據實際情況上傳CA 證書、客戶端證書、客戶端證書私鑰,輸入客戶端證書私鑰密碼。
說明若自建PostgreSQL數據庫選擇了SSL安全連接,則必須上傳CA 證書。
若您需要使用客戶端證書,則需要同時上傳客戶端證書和客戶端證書私鑰,并輸入客戶端證書私鑰密碼。
RDS PostgreSQL實例的SSL加密功能,請參見SSL鏈路加密。
目標庫信息
數據庫類型
選擇PolarDB(兼容Oracle)。
接入方式
選擇通過專線/VPN網關/智能網關接入的自建數據庫。
實例地區
選擇目標PolarDB PostgreSQL版(兼容Oracle)集群所屬地域。
已和目標端數據庫聯通的VPC
選擇目標PolarDB PostgreSQL版(兼容Oracle)集群所屬的專有網絡ID。您可以在集群的基本信息頁面中查看到專有網絡ID。
DNS或IP地址
填入目標PolarDB PostgreSQL版(兼容Oracle)集群主節點的訪問地址。
說明您可以在電腦中通過Ping命令來獲取目標PolarDB PostgreSQL版(兼容Oracle)集群直連訪問地址對應的IP地址。
端口
填入目標數據庫的服務端口,默認為1521。
數據庫名稱
填入目標PolarDB PostgreSQL版(兼容Oracle)集群中遷移對象所屬數據庫的名稱。
數據庫賬號
填入目標PolarDB PostgreSQL版(兼容Oracle)集群的數據庫賬號,權限要求請參見數據庫賬號的權限要求。
數據庫密碼
填入該數據庫賬號對應的密碼。
如果您的自建數據庫具備白名單安全設置,您需要復制彈跳框中的DTS服務器IP地址,并加入自建數據庫的白名單安全設置中。然后單擊測試連接。
警告DTS自動添加或您手動添加DTS服務的公網IP地址段可能會存在安全風險,一旦使用本產品代表您已理解和確認其中可能存在的安全風險,并且需要您做好基本的安全防護,包括但不限于加強賬號密碼強度防范、限制各網段開放的端口號、內部各API使用鑒權方式通信、定期檢查并限制不需要的網段,或者使用通過內網(專線/VPN網關/智能網關)的方式接入。
配置任務對象及高級配置。
配置
說明
遷移類型
如果只需要進行全量遷移,請同時選中庫表結構遷移和全量遷移。
如果需要進行不停機遷移,請同時選中庫表結構遷移、全量遷移和增量遷移。
說明如果未選擇增量遷移,為保障數據一致性,數據遷移期間請勿在源實例中寫入新的數據。
目標已存在表的處理模式
預檢查并報錯攔截:檢查目標數據庫中是否有同名的表。如果目標數據庫中沒有同名的表,則通過該檢查項目;如果目標數據庫中有同名的表,則在預檢查階段提示錯誤,數據遷移任務不會被啟動。
說明如果目標庫中同名的表不方便刪除或重命名,您可以更改該表在目標庫中的名稱,請參見庫表列名映射。
忽略報錯并繼續執行:跳過目標數據庫中是否有同名表的檢查項。
警告選擇為忽略報錯并繼續執行,可能導致數據不一致,給業務帶來風險,例如:
表結構一致的情況下,在目標庫遇到與源庫主鍵的值相同的記錄:
全量期間,DTS會保留目標集群中的該條記錄,即源庫中的該條記錄不會遷移至目標數據庫中。
增量期間,DTS不會保留目標集群中的該條記錄,即源庫中的該條記錄會覆蓋至目標數據庫中。
表結構不一致的情況下,可能導致只能遷移部分列的數據或遷移失敗,請謹慎操作。
源庫對象
在源庫對象框中單擊待遷移對象,然后單擊將其移動至已選擇對象框。
說明遷移對象選擇的粒度為Schema、表、列。若選擇的遷移對象為表或列,其他對象(如視圖、觸發器、存儲過程)不會被遷移至目標庫。
已選擇對象
如需更改單個遷移對象在目標實例中的名稱,請右擊已選擇對象中的遷移對象,設置方式,請參見庫表列名單個映射。
如需批量更改遷移對象在目標實例中的名稱,請單擊已選擇對象方框右上方的批量編輯,設置方式,請參見庫表列名批量映射。
說明如果使用了對象名映射功能,可能會導致依賴這個對象的其他對象遷移失敗。
如需設置WHERE條件過濾數據,請在已選擇對象中右擊待遷移的表,在彈出的對話框中設置過濾條件。設置方法請參見設置過濾條件。
如需按庫或表級別選擇遷移的SQL操作,請在已選擇對象中右擊待遷移對象,并在彈出的對話框中選擇所需遷移的SQL操作。支持的操作請參見支持增量遷移的SQL操作。
單擊下一步高級配置,進行高級配置。
配置
說明
監控報警
是否設置告警,當遷移失敗或延遲超過閾值后,將通知告警聯系人。
不設置:不設置告警。
設置:設置告警,您還需要設置告警閾值和告警聯系人。更多信息,請參見在配置任務過程中配置監控告警。
源庫、目標庫無法連接后的重試時間
在遷移任務連接失敗時,DTS會立即進行持續的重試連接,默認持續重試時間為120分鐘,您也可以在取值范圍(10~1440分鐘)內自定義重試時間,建議設置30分鐘以上。如果DTS在設置的重試時間內重新連接上源庫、目標庫,遷移任務將自動恢復。否則,遷移任務將失敗。
說明針對同源或者同目標的多個DTS實例,如DTS實例A和DTS實例B,設置網絡重試時間時A設置30分鐘,B設置60分鐘,則重試時間以低的30分鐘為準。
由于連接重試期間,DTS將收取任務運行費用,建議您根據業務需要自定義重試時間,或者在源和目標庫實例釋放后盡快釋放DTS實例。
源庫、目標庫出現其他問題后的重試時間
在遷移任務啟動后,若源庫或目標庫出現非連接性的其他問題(如DDL或DML執行異常),則DTS會報錯并會立即進行持續的重試操作,默認持續重試時間為10分鐘,您也可以在取值范圍(1~1440分鐘)內自定義重試時間,建議設置10分鐘以上。如果DTS在設置的重試時間內相關操作執行成功,遷移任務將自動恢復。否則,遷移任務將會失敗。
重要源庫、目標庫出現其他問題后的重試時間的值需要小于源庫、目標庫無法連接后的重試時間的值。
配置ETL功能
選擇是否配置ETL功能。關于ETL的更多信息,請參見什么是ETL。
是:配置ETL功能,并在文本框中填寫數據處理語句,詳情請參見在DTS遷移或同步任務中配置ETL。
否:不配置ETL功能。
上述配置完成后,單擊頁面下方的下一步保存任務并預檢查。
您可以將鼠標光標移動至下一步保存任務并預檢查按鈕上,然后單擊氣泡中的預覽OpenAPI參數,查看調用API接口配置該實例時的參數信息。
說明在遷移任務正式啟動之前,會先進行預檢查。只有預檢查通過后,才能成功啟動遷移任務。
如果預檢查失敗,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
如果預檢查產生警告:
對于不可以忽略的檢查項,請單擊失敗檢查項后的查看詳情,并根據提示修復后重新進行預檢查。
對于可以忽略無需修復的檢查項,您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預檢查,跳過告警檢查項重新進行預檢查。如果選擇屏蔽告警檢查項,可能會導致數據不一致等問題,給業務帶來風險。
預檢查通過率顯示為100%時,單擊下一步購買。
在購買頁面,選擇數據遷移實例的鏈路規格,詳細說明請參見下表。
類別
參數
說明
信息配置
資源組配置
選擇實例所屬的資源組,默認為default resource group。更多信息,請參見什么是資源管理。
鏈路規格
DTS為您提供了不同性能的遷移規格,遷移鏈路規格的不同會影響遷移速率,您可以根據業務場景進行選擇。更多信息,請參見數據遷移鏈路規格說明。
配置完成后,閱讀并選中《數據傳輸(按量付費)服務條款》。
單擊購買并啟動,并在彈出的確認對話框,單擊確定。
您可在數據遷移界面查看具體進度。