本文介紹如何使用Data Transmission Service將自建PostgreSQL遷移至PolarDB PostgreSQL版。
前提條件
已建立目標PolarDB PostgreSQL版資料庫叢集,詳情請參見建立PolarDB PostgreSQL版資料庫叢集。
說明源庫和目標庫支援的版本,請參見遷移方案概覽。
目標PolarDB PostgreSQL版執行個體的儲存空間須大於源自建PostgreSQL執行個體佔用的儲存空間。
注意事項
在庫表結構遷移過程中,DTS會將來源資料庫中的外鍵遷移到目標資料庫。
在全量遷移和增量遷移過程中,DTS會以Session層級暫時禁用約束檢查以及外鍵級聯操作。若任務運行時源庫存在串聯更新、刪除操作,可能會導致資料不一致。
類型 | 說明 |
源庫限制 |
|
其他限制 |
|
費用說明
遷移類型 | 鏈路配置費用 | 公網流量費用 |
結構遷移和全量資料移轉 | 不收費。 | 通過公網將資料移轉出阿里雲時將收費,詳情請參見計費概述。 |
增量資料移轉 | 收費,詳情請參見計費概述。 |
遷移類型說明
庫表結構遷移
DTS將源庫中遷移對象的結構定義遷移到目標庫。
全量遷移
DTS將源庫中遷移對象的存量資料,全部遷移到目標庫中。
增量遷移
DTS在全量遷移的基礎上,將源庫的累加式更新資料移轉到目標庫中。通過增量資料移轉可以實現在自建應用不停機的情況下,平滑地完成資料移轉。
支援增量遷移的SQL操作
操作類型 | SQL動作陳述式 |
DML | INSERT、UPDATE、DELETE |
DDL |
|
資料庫帳號的許可權要求
資料庫 | 庫表結構遷移 | 全量遷移 | 增量遷移 |
自建PostgreSQL | pg_catalog的usage許可權。 | 遷移對象的select許可權。 | superuser許可權。 |
PolarDB PostgreSQL版 | 目標Schema的Owner許可權。 說明 您可以使用建立資料庫時指定的資料庫Owner。 |
資料庫帳號建立及授權方法:
自建PostgreSQL資料庫請參見CREATE USER和GRANT文法。
準備工作
若您的源庫為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介面布局與樣式。
您也可以登入新版DTS遷移工作清單頁面。
在遷移任務右側,選擇遷移執行個體所屬地區。
說明新版DTS遷移工作清單頁面,需要在頁面左上方選擇遷移執行個體所屬地區。
單擊建立任務,配置源庫及目標庫資訊。
警告選擇源和目標執行個體後,建議您仔細閱讀頁面上方顯示的使用限制,以成功建立並執行遷移任務。
類別
配置
說明
無
任務名稱
DTS會自動產生一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便於後續識別。
源庫資訊
選擇已有的DMS資料庫執行個體(可選,如未建立可忽略此處選擇,直接在下方設定資料庫資訊即可)
您可以按實際需求,選擇是否使用已有執行個體。
如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。
如不使用已有執行個體,您需要輸入下方的資料庫資訊。
資料庫類型
選擇PostgreSQL。
接入方式
請根據源庫的部署位置進行選擇,本樣本以ECS自建資料庫為例介紹配置流程。
說明當選擇其他方式接入自建資料庫時,您還需要執行相應的準備工作,詳情請參見準備工作概覽。
執行個體地區
選擇自建PostgreSQL資料庫所屬地區。
ECS執行個體ID
填入自建PostgreSQL資料庫所屬的ECS執行個體ID。
連接埠
填入自建PostgreSQL資料庫的服務連接埠,預設為5432。
資料庫名稱
填入自建PostgreSQL資料庫中遷移對象所屬資料庫的名稱。
資料庫帳號
填入自建PostgreSQL的資料庫帳號,許可權要求請參見資料庫帳號的許可權要求。
資料庫密碼
填入該資料庫帳號對應的密碼。
串連方式
請根據實際情況選擇,本樣本選擇非加密串連。
若您需要SSL加密的方式串連資料庫,請選擇SSL安全連線,並根據實際情況上傳CA 憑證、客戶端認證、客戶端認證私密金鑰,輸入客戶端認證私密金鑰密碼。
說明若自建PostgreSQL資料庫選擇了SSL安全連線,則必須上傳CA 憑證。
若您需要使用用戶端認證,則需要同時上傳客戶端認證和客戶端認證私密金鑰,並輸入客戶端認證私密金鑰密碼。
RDS PostgreSQL執行個體的SSL加密功能,請參見SSL鏈路加密。
目標庫資訊
選擇已有的DMS資料庫執行個體(可選,如未建立可忽略此處選擇,直接在下方設定資料庫資訊即可)
您可以按實際需求,選擇是否使用已有執行個體。
如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。
如不使用已有執行個體,您需要輸入下方的資料庫資訊。
資料庫類型
選擇PolarDB for PostgreSQL。
接入方式
選擇雲執行個體。
執行個體地區
選擇目標PolarDB PostgreSQL版叢集所屬地區。
執行個體ID
選擇目標PolarDB PostgreSQL版叢集的ID。
資料庫名稱
填入目標PolarDB PostgreSQL版叢集中遷移對象所屬資料庫的名稱。
資料庫帳號
填入目標PolarDB PostgreSQL版叢集的資料庫帳號,許可權要求請參見資料庫帳號的許可權要求。
資料庫密碼
填入該資料庫帳號對應的密碼。
配置完成後,單擊頁面下方的測試連接以進行下一步。
如果源或目標資料庫是阿里雲資料庫執行個體(例如RDS MySQL、ApsaraDB 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網關/智能網關)的方式接入。
配置任務對象及進階配置。
配置
說明
遷移類型
如果只需要進行全量遷移,請同時選中庫表結構遷移和全量遷移。
如果需要進行不停機遷移,請同時選中庫表結構遷移、全量遷移和增量遷移。
說明如果未選擇增量遷移,為保障資料一致性,資料移轉期間請勿在源執行個體中寫入新的資料。
目標已存在表的處理模式
預檢查並報錯攔截:檢查目標資料庫中是否有同名的表。如果目標資料庫中沒有同名的表,則通過該檢查專案;如果目標資料庫中有同名的表,則在預檢查階段提示錯誤,資料移轉任務不會被啟動。
說明如果目標庫中同名的表不方便刪除或重新命名,您可以更改該表在目標庫中的名稱,請參見庫表列名映射。
忽略報錯並繼續執行:跳過目標資料庫中是否有同名表的檢查項。
警告選擇為忽略報錯並繼續執行,可能導致資料不一致,給業務帶來風險,例如:
表結構一致的情況下,在目標庫遇到與源庫主鍵的值相同的記錄:
全量期間,DTS會保留目的地組群中的該條記錄,即源庫中的該條記錄不會遷移至目標資料庫中。
增量期間,DTS不會保留目的地組群中的該條記錄,即源庫中的該條記錄會覆蓋至目標資料庫中。
表結構不一致的情況下,可能導致只能遷移部分列的資料或遷移失敗,請謹慎操作。
源庫對象
在源庫對象框中單擊待遷移的對象,然後單擊將其移動到已選擇對象框。
說明遷移對象選擇的粒度為Schema、表、列。若選擇的遷移對象為表或列,其他對象(如視圖、觸發器、預存程序)不會被遷移至目標庫。
已選擇對象
如需更改單個遷移對象在目標執行個體中的名稱,請右擊已選擇對象中的遷移對象,設定方式,請參見庫表列名單個映射。
如需批量更改遷移對象在目標執行個體中的名稱,請單擊已選擇對象方框右上方的大量編輯,設定方式,請參見庫表列名批量映射。
說明如果使用了對象名映射功能,可能會導致依賴這個對象的其他對象遷移失敗。
如需設定WHERE條件過濾資料,請在已選擇對象中右擊待遷移的表,在彈出的對話方塊中設定過濾條件。設定方法請參見設定過濾條件。
如需按庫或表層級選擇遷移的SQL操作,請在已選擇對象中右擊待遷移對象,並在彈出的對話方塊中選擇所需遷移的SQL操作。支援的操作請參見支援增量遷移的SQL操作。
單擊下一步高級配置,進行進階配置。
數據校正配置
若您需要使用資料校正功能,配置方法請參見配置資料校正。
高級配置
配置
說明
選擇調度該任務的專屬叢集
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為您提供了不同效能的遷移規格,遷移鏈路規格的不同會影響遷移速率,您可以根據業務情境進行選擇。更多資訊,請參見資料移轉鏈路規格說明。
配置完成後,閱讀並選中《資料轉送(隨用隨付)服務條款》。
單擊購買並啟動,並在彈出的確認對話方塊,單擊確定。
您可在資料移轉介面查看具體進度。