PolarDB-X 2.0同步至MaxCompute
本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業(yè)務(wù)造成影響,請務(wù)必仔細閱讀。
本文介紹如何使用數(shù)據(jù)傳輸服務(wù)DTS(Data Transmission Service),將PolarDB-X 2.0同步至MaxCompute。
前提條件
已創(chuàng)建源PolarDB-X 2.0實例,且兼容MySQL 5.7版本。更多信息,請參見創(chuàng)建實例和創(chuàng)建數(shù)據(jù)庫。
已開通MaxCompute。更多信息,請參見開通MaxCompute和DataWorks。
已創(chuàng)建MaxCompute項目。更多信息,請參見創(chuàng)建MaxCompute項目。
已設(shè)置MaxCompute白名單,允許DTS訪問MaxCompute。更多信息,請參見設(shè)置阿里云產(chǎn)品訪問MaxCompute白名單。
注意事項
DTS不會將源數(shù)據(jù)庫中的外鍵同步到目標數(shù)據(jù)庫,因此源數(shù)據(jù)庫的級聯(lián)、刪除等操作不會同步到目標數(shù)據(jù)庫。
類型 | 說明 |
源庫限制 |
|
其他限制 |
|
其他注意事項 | DTS會在源庫定時更新`dts_health_check`.`ha_health_check`表以推進binlog位點。 |
費用說明
同步類型 | 鏈路配置費用 |
庫表結(jié)構(gòu)同步和全量數(shù)據(jù)同步 | 不收費。 |
增量數(shù)據(jù)同步 | 收費,詳情請參見計費概述。 |
支持同步的SQL操作
操作類型 | SQL操作語句 |
DML | INSERT、UPDATE、DELETE |
DDL | ALTER TABLE、ADD COLUMN 說明 不支持同步含非空約束(NOT NULL)的加列操作。 |
操作步驟
進入同步任務(wù)的列表頁面。
在頂部菜單欄中,單擊集成與開發(fā)。
在左側(cè)導(dǎo)航欄,選擇 。
說明實際操作可能會因DMS的模式和布局不同,而有所差異。更多信息,請參見極簡模式和自定義DMS界面布局與樣式。
您也可以登錄新版DTS同步任務(wù)的列表頁面。
在同步任務(wù)右側(cè),選擇同步實例所屬地域。
說明新版DTS同步任務(wù)列表頁面,需要在頁面左上角選擇同步實例所屬地域。
單擊創(chuàng)建任務(wù),配置源庫及目標庫信息。
類別
配置
說明
無
任務(wù)名稱
DTS會自動生成一個任務(wù)名稱,建議配置具有業(yè)務(wù)意義的名稱(無唯一性要求),便于后續(xù)識別。
源庫信息
選擇DMS數(shù)據(jù)庫實例
您可以按實際需求,選擇是否使用已有實例。
如使用已有實例,下方數(shù)據(jù)庫信息將自動填入,您無需重復(fù)輸入。
如不使用已有實例,您需要輸入下方的數(shù)據(jù)庫信息。
數(shù)據(jù)庫類型
選擇PolarDB-X 2.0。
接入方式
選擇云實例。
實例地區(qū)
選擇PolarDB-X 2.0實例所屬地域。
是否跨阿里云賬號
本示例為同一阿里云賬號間的同步,選擇不跨賬號。
實例ID
選擇源PolarDB-X 2.0實例ID。
數(shù)據(jù)庫賬號
填入PolarDB-X 2.0的數(shù)據(jù)庫賬號,需具備REPLICATION SLAVE、REPLICATION CLIENT及待同步對象的SELECT權(quán)限。
說明授權(quán)方式,請參見數(shù)據(jù)同步過程中的賬號權(quán)限問題。
數(shù)據(jù)庫密碼
填入該數(shù)據(jù)庫賬號對應(yīng)的密碼。
目標庫信息
選擇DMS數(shù)據(jù)庫實例
您可以按實際需求,選擇是否使用已有實例。
如使用已有實例,下方數(shù)據(jù)庫信息將自動填入,您無需重復(fù)輸入。
如不使用已有實例,您需要輸入下方的數(shù)據(jù)庫信息。
數(shù)據(jù)庫類型
選擇MaxCompute。
接入方式
選擇云實例。
實例地區(qū)
選擇目標MaxCompute實例所屬地域。
Project
填入MaxCompute實例的Project,您可以在MaxCompute工作空間列表頁面中查詢。
主賬號AccessKeyId
填入用于標識主賬號的AccessKey Id,獲取方式請參見創(chuàng)建AccessKey。
主賬號AccessKeySecret
填入用于驗證主賬號的密鑰AccessKey Secret,獲取方式請參見創(chuàng)建AccessKey。
配置完成后,單擊頁面下方的測試連接以進行下一步。
如果源或目標數(shù)據(jù)庫是阿里云數(shù)據(jù)庫實例(例如RDS MySQL、云數(shù)據(jù)庫MongoDB版等),DTS會自動將對應(yīng)地區(qū)DTS服務(wù)的IP地址添加到阿里云數(shù)據(jù)庫實例的白名單中;如果源或目標數(shù)據(jù)庫是ECS上的自建數(shù)據(jù)庫,DTS會自動將對應(yīng)地區(qū)DTS服務(wù)的IP地址添加到ECS的安全規(guī)則中,您還需確保自建數(shù)據(jù)庫沒有限制ECS的訪問(若數(shù)據(jù)庫是集群部署在多個ECS實例,您需要手動將DTS服務(wù)對應(yīng)地區(qū)的IP地址添到其余每個ECS的安全規(guī)則中);如果源或目標數(shù)據(jù)庫是IDC自建數(shù)據(jù)庫或其他云數(shù)據(jù)庫,則需要您手動添加對應(yīng)地區(qū)DTS服務(wù)的IP地址,以允許來自DTS服務(wù)器的訪問。DTS服務(wù)的IP地址,請參見DTS服務(wù)器的IP地址段。
警告DTS自動添加或您手動添加DTS服務(wù)的公網(wǎng)IP地址段可能會存在安全風(fēng)險,一旦使用本產(chǎn)品代表您已理解和確認其中可能存在的安全風(fēng)險,并且需要您做好基本的安全防護,包括但不限于加強賬號密碼強度防范、限制各網(wǎng)段開放的端口號、內(nèi)部各API使用鑒權(quán)方式通信、定期檢查并限制不需要的網(wǎng)段,或者使用通過內(nèi)網(wǎng)(專線/VPN網(wǎng)關(guān)/智能網(wǎng)關(guān))的方式接入。
單擊確定,完成ODPS賬號授權(quán)。
配置任務(wù)對象及高級配置。
配置
說明
同步類型
固定選中增量同步。默認情況下,您還需要同時選中庫表結(jié)構(gòu)同步和全量同步。預(yù)檢查完成后,DTS會將源實例中待同步對象的全量數(shù)據(jù)在目標集群中初始化,作為后續(xù)增量同步數(shù)據(jù)的基線數(shù)據(jù)。
目標已存在表的處理模式
預(yù)檢查并報錯攔截:檢查目標數(shù)據(jù)庫中是否有同名的表。如果目標數(shù)據(jù)庫中沒有同名的表,則通過該檢查項目;如果目標數(shù)據(jù)庫中有同名的表,則在預(yù)檢查階段提示錯誤,數(shù)據(jù)同步任務(wù)不會被啟動。
說明如果目標庫中同名的表不方便刪除或重命名,您可以更改該表在目標庫中的名稱,請參見庫表列名映射。
忽略報錯并繼續(xù)執(zhí)行:跳過目標數(shù)據(jù)庫中是否有同名表的檢查項。
警告選擇為忽略報錯并繼續(xù)執(zhí)行,可能導(dǎo)致數(shù)據(jù)不一致,給業(yè)務(wù)帶來風(fēng)險,例如:
表結(jié)構(gòu)一致的情況下,如在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄:
全量期間,DTS會保留目標集群中的該條記錄,即源庫中的該條記錄不會同步至目標數(shù)據(jù)庫中。
增量期間,DTS不會保留目標集群中的該條記錄,即源庫中的該條記錄會覆蓋至目標數(shù)據(jù)庫中。
表結(jié)構(gòu)不一致的情況下,可能會導(dǎo)致無法初始化數(shù)據(jù)、只能同步部分列的數(shù)據(jù)或同步失敗,請謹慎操作。
附加列規(guī)則
DTS在將數(shù)據(jù)同步到MaxCompute時,會在同步的目標表中添加一些附加列。如果附加列和目標表中已有的列出現(xiàn)名稱沖突將會導(dǎo)致數(shù)據(jù)同步失敗。您需要根據(jù)業(yè)務(wù)需求選擇新規(guī)則或舊規(guī)則。
警告在選擇附加列規(guī)則前,您需要評估附加列和目標表中已有的列是否會出現(xiàn)名稱沖突,否則可能會導(dǎo)致數(shù)據(jù)丟失或任務(wù)失敗。關(guān)于附加列的規(guī)則和定義說明,請參見附加列名稱和定義說明。
增量日志表分區(qū)定義
根據(jù)業(yè)務(wù)需求,選擇分區(qū)名稱。關(guān)于分區(qū)的相關(guān)介紹請參見分區(qū)。
目標庫對象名稱大小寫策略
您可以配置目標實例中同步對象的庫名、表名和列名的英文大小寫策略。默認情況下選擇DTS默認策略,您也可以選擇與源庫、目標庫默認策略保持一致。更多信息,請參見目標庫對象名稱大小寫策略。
源庫對象
在源庫對象框中單擊待同步對象,然后單擊將其移動至已選擇對象框。
說明同步對象選擇的粒度為表。
已選擇對象
如需更改單個同步對象在目標實例中的名稱,請右擊已選擇對象中的同步對象,設(shè)置方式,請參見庫表列名單個映射。
如需批量更改同步對象在目標實例中的名稱,請單擊已選擇對象方框右上方的批量編輯,設(shè)置方式,請參見庫表列名批量映射。
說明如需按庫或表級別選擇同步的SQL操作,請在已選擇對象中右擊待同步對象,并在彈出的對話框中選擇所需同步的SQL操作。支持的操作請參見支持同步的SQL操作。
如需設(shè)置WHERE條件過濾數(shù)據(jù),請在已選擇對象中右擊待同步的表,在彈出的對話框中設(shè)置過濾條件。設(shè)置方法請參見通過SQL條件過濾任務(wù)數(shù)據(jù)。
單擊下一步高級配置,進行高級配置。
配置
說明
選擇調(diào)度該任務(wù)的專屬集群
DTS默認將任務(wù)調(diào)度到共享集群上,您無需選擇。若您希望任務(wù)更加穩(wěn)定,可以購買專屬集群來運行DTS同步任務(wù)。更多信息,請參見什么是DTS專屬集群。
源庫、目標庫無法連接后的重試時間
在同步任務(wù)啟動后,若源庫或目標庫連接失敗則DTS會報錯,并會立即進行持續(xù)的重試連接,默認持續(xù)重試時間為720分鐘,您也可以在取值范圍(10~1440分鐘)內(nèi)自定義重試時間,建議設(shè)置30分鐘以上。如果DTS在設(shè)置的重試時間內(nèi)重新連接上源庫、目標庫,同步任務(wù)將自動恢復(fù)。否則,同步任務(wù)將會失敗。
說明針對同源或者同目標的多個DTS實例,如DTS實例A和DTS實例B,設(shè)置網(wǎng)絡(luò)重試時間時A設(shè)置30分鐘,B設(shè)置60分鐘,則重試時間以低的30分鐘為準。
由于連接重試期間,DTS將收取任務(wù)運行費用,建議您根據(jù)業(yè)務(wù)需要自定義重試時間,或者在源和目標庫實例釋放后盡快釋放DTS實例。
源庫、目標庫出現(xiàn)其他問題后的重試時間
在同步任務(wù)啟動后,若源庫或目標庫出現(xiàn)非連接性的其他問題(如DDL或DML執(zhí)行異常),則DTS會報錯并會立即進行持續(xù)的重試操作,默認持續(xù)重試時間為10分鐘,您也可以在取值范圍(1~1440分鐘)內(nèi)自定義重試時間,建議設(shè)置10分鐘以上。如果DTS在設(shè)置的重試時間內(nèi)相關(guān)操作執(zhí)行成功,同步任務(wù)將自動恢復(fù)。否則,同步任務(wù)將會失敗。
重要源庫、目標庫出現(xiàn)其他問題后的重試時間的值需要小于源庫、目標庫無法連接后的重試時間的值。
是否限制全量遷移速率
在全量同步階段,DTS將占用源庫和目標庫一定的讀寫資源,可能會導(dǎo)致數(shù)據(jù)庫的負載上升。您可以根據(jù)實際情況,選擇是否對全量同步任務(wù)進行限速設(shè)置(設(shè)置每秒查詢源庫的速率QPS、每秒全量遷移的行數(shù)RPS和每秒全量遷移的數(shù)據(jù)量(MB)BPS),以緩解目標庫的壓力。
說明僅當(dāng)同步類型選擇了全量同步時才可以配置。
是否限制增量同步速率
您也可以根據(jù)實際情況,選擇是否對增量同步任務(wù)進行限速設(shè)置(設(shè)置每秒增量同步的行數(shù)RPS和每秒增量同步的數(shù)據(jù)量(MB)BPS),以緩解目標庫的壓力。
環(huán)境標簽
您可以根據(jù)實際情況,選擇用于標識實例的環(huán)境標簽。本示例無需選擇。
是否去除正反向任務(wù)的心跳表sql
根據(jù)業(yè)務(wù)需求選擇是否在DTS實例運行時,在源庫中寫入心跳SQL信息。
是:不在源庫中寫入心跳SQL信息,DTS實例可能會顯示有延遲。
否:在源庫中寫入心跳SQL信息,可能會影響源庫的物理備份和克隆等功能。
配置ETL功能
選擇是否配置ETL功能。關(guān)于ETL的更多信息,請參見什么是ETL。
是:配置ETL功能,并在文本框中填寫數(shù)據(jù)處理語句,詳情請參見在DTS遷移或同步任務(wù)中配置ETL。
否:不配置ETL功能。
監(jiān)控告警
是否設(shè)置告警,當(dāng)同步失敗或延遲超過閾值后,將通知告警聯(lián)系人。
不設(shè)置:不設(shè)置告警。
設(shè)置:設(shè)置告警,您還需要設(shè)置告警閾值和告警聯(lián)系人。更多信息,請參見在配置任務(wù)過程中配置監(jiān)控告警。
保存任務(wù)并進行預(yù)檢查。
若您需要查看調(diào)用API接口配置該實例時的參數(shù)信息,請將鼠標光標移動至下一步保存任務(wù)并預(yù)檢查按鈕上,然后單擊氣泡中的預(yù)覽OpenAPI參數(shù)。
若您無需查看或已完成查看API參數(shù),請單擊頁面下方的下一步保存任務(wù)并預(yù)檢查。
說明在同步作業(yè)正式啟動之前,會先進行預(yù)檢查。只有預(yù)檢查通過后,才能成功啟動同步作業(yè)。
如果預(yù)檢查失敗,請單擊失敗檢查項后的查看詳情,并根據(jù)提示修復(fù)后重新進行預(yù)檢查。
如果預(yù)檢查產(chǎn)生警告:
對于不可以忽略的檢查項,請單擊失敗檢查項后的查看詳情,并根據(jù)提示修復(fù)后重新進行預(yù)檢查。
對于可以忽略無需修復(fù)的檢查項,您可以依次單擊點擊確認告警詳情、確認屏蔽、確定、重新進行預(yù)檢查,跳過告警檢查項重新進行預(yù)檢查。如果選擇屏蔽告警檢查項,可能會導(dǎo)致數(shù)據(jù)不一致等問題,給業(yè)務(wù)帶來風(fēng)險。
預(yù)檢查通過率顯示為100%時,單擊下一步購買。
在購買頁面,選擇數(shù)據(jù)同步實例的計費方式、鏈路規(guī)格,詳細說明請參見下表。
類別
參數(shù)
說明
信息配置
計費方式
預(yù)付費(包年包月):在新建實例時支付費用。適合長期需求,價格比按量付費更實惠,且購買時長越長,折扣越多。
后付費(按量付費):按小時扣費。適合短期需求,用完可立即釋放實例,節(jié)省費用。
資源組配置
實例所屬的資源組,默認為default resource group。更多信息,請參見什么是資源管理。
鏈路規(guī)格
DTS為您提供了不同性能的同步規(guī)格,同步鏈路規(guī)格的不同會影響同步速率,您可以根據(jù)業(yè)務(wù)場景進行選擇。更多信息,請參見數(shù)據(jù)同步鏈路規(guī)格說明。
訂購時長
在預(yù)付費模式下,選擇包年包月實例的時長和數(shù)量,包月可選擇1~9個月,包年可選擇1年、2年、3年和5年。
說明該選項僅在付費類型為預(yù)付費時出現(xiàn)。
配置完成后,閱讀并勾選《數(shù)據(jù)傳輸(按量付費)服務(wù)條款》。
單擊購買并啟動,并在彈出的確認對話框,單擊確定。
您可在數(shù)據(jù)同步界面查看具體任務(wù)進度。
增量日志表結(jié)構(gòu)定義說明
你需要在MaxCompute中執(zhí)行set odps.sql.allow.fullscan=true;
,設(shè)置項目空間屬性,允許進行全表掃描。
DTS在將MySQL產(chǎn)生的增量數(shù)據(jù)同步至MaxCompute的增量日志表時,除了存儲增量數(shù)據(jù),還會存儲一些元信息,示例如下。
示例中的modifytime_year
、modifytime_month
、modifytime_day
、modifytime_hour
、modifytime_minute
為分區(qū)字段,是在配置任務(wù)對象及高級配置步驟中指定的。
結(jié)構(gòu)定義說明
字段 | 說明 |
record_id | 增量日志的記錄ID,為該日志唯一標識。 說明
|
operation_flag | 操作類型,取值:
|
utc_timestamp | 操作時間戳,即binlog的時間戳(UTC 時間)。 |
before_flag | 所有列的值是否為更新前的值,取值:Y或N。 |
after_flag | 所有列的值是否為更新后的值,取值:Y或N。 |
關(guān)于before_flag和after_flag的補充說明
對于不同的操作類型,增量日志中的before_flag和after_flag定義如下:
INSERT
當(dāng)操作類型為INSERT時,所有列的值為新插入的記錄值,即為更新后的值,所以before_flag取值為N,after_flag取值為Y,示例如下。
UPDATE
當(dāng)操作類型為UPDATE時,DTS會將UPDATE操作拆為兩條增量日志。這兩條增量日志的record_id、operation_flag及utc_timestamp對應(yīng)的值相同。
第一條增量日志記錄了更新前的值,所以before_flag取值為Y,after_flag取值為N。第二條增量日志記錄了更新后的值,所以before_flag取值為N,after_flag取值為Y,示例如下。
DELETE
當(dāng)操作類型為DELETE時,增量日志中所有的列值為被刪除的值,即列值不變,所以before_flag取值為Y,after_flag取值為N,示例如下。
全量數(shù)據(jù)合并示例
執(zhí)行數(shù)據(jù)同步的操作后,DTS會在MaxCompute中分別創(chuàng)建該表的全量基線表和增量日志表。您可以通過MaxCompute的SQL命令,對這兩個表執(zhí)行合并操作,得到某個時間點的全量數(shù)據(jù)。
本案例以customer表為例(表結(jié)構(gòu)如下),介紹操作流程。
根據(jù)源庫中待同步表的結(jié)構(gòu),在MaxCompute中創(chuàng)建用于存儲合并結(jié)果的表。
例如,需要獲取customer表在
1565944878
時間點的全量數(shù)據(jù)。為方便業(yè)務(wù)識別,創(chuàng)建如下數(shù)據(jù)表:CREATE TABLE `customer_1565944878` ( `id` bigint NULL, `register_time` datetime NULL, `address` string);
說明您可以在MaxCompute的臨時查詢中,運行SQL命令。
關(guān)于MaxCompute支持的數(shù)據(jù)類型與相關(guān)說明,請參見數(shù)據(jù)類型。
在MaxCompute中執(zhí)行如下SQL命令,合并全量基線表和增量日志表,獲取該表在某一時間點的全量數(shù)據(jù)。
set odps.sql.allow.fullscan=true; insert overwrite table <result_storage_table> select <col1>, <col2>, <colN> from( select row_number() over(partition by t.<primary_key_column> order by record_id desc, after_flag desc) as row_number, record_id, operation_flag, after_flag, <col1>, <col2>, <colN> from( select incr.record_id, incr.operation_flag, incr.after_flag, incr.<col1>, incr.<col2>,incr.<colN> from <table_log> incr where utc_timestamp< <timestamp> union all select 0 as record_id, 'I' as operation_flag, 'Y' as after_flag, base.<col1>, base.<col2>,base.<colN> from <table_base> base) t) gt where row_number=1 and after_flag='Y'
說明<result_storage_table>:存儲全量merge結(jié)果集的表名。
<col1>/<col2>/<colN>:同步表中的列名。
<primary_key_column>:同步表中的主鍵列名。
<table_log>:增量日志表名。
<table_base>:全量基線表名。
<timestamp>:需要獲取全量數(shù)據(jù)的時間點。
合并數(shù)據(jù)表,獲取customer表在
1565944878
時間點的全量數(shù)據(jù),示例如下:set odps.sql.allow.fullscan=true; insert overwrite table customer_1565944878 select id, register_time, address from( select row_number() over(partition by t.id order by record_id desc, after_flag desc) as row_number, record_id, operation_flag, after_flag, id, register_time, address from( select incr.record_id, incr.operation_flag, incr.after_flag, incr.id, incr.register_time, incr.address from customer_log incr where utc_timestamp< 1565944878 union all select 0 as record_id, 'I' as operation_flag, 'Y' as after_flag, base.id, base.register_time, base.address from customer_base base) t) gt where gt.row_number= 1 and gt.after_flag= 'Y';
上述命令執(zhí)行完成后,可在customer_1565944878表中查詢合并后的數(shù)據(jù)。