全部產品
Search
文件中心

Data Transmission Service:RDS MySQL同步至Function ComputeFC

更新時間:Nov 29, 2024

Data Transmission Service支援將RDS MySQL執行個體的全量或增量資料同步至Function ComputeFC的指定函數。您可以編寫函數代碼,結合約步至函數中的資料,對資料進行二次加工。

前提條件

  • 已建立源RDS MySQL執行個體。

  • 已建立請求處理常式類型處理事件請求的目標服務和函數資源。建立方式,請參見快速建立函數

注意事項

類型

說明

源庫限制

  • 待同步的表需具備主鍵或唯一約束,且欄位具有唯一性。

  • 若源庫待同步的資料中,單條資料不能超過16 MB,否則DTS任務會因無法將資料寫入到Function ComputeFC而產生報錯。若您需要同步部分欄位,可以使用ETL功能過濾大欄位的資料。

  • 如同步對象為表層級,則單次同步任務僅支援同步至多1000張表。當超出數量限制,任務提交後會顯示請求報錯,此時建議您拆分待同步的表,分批配置多個任務,或者配置整庫的同步任務。

  • Binlog日誌:

    • RDS MySQL預設已開啟Binlog,您需確保binlog_row_image的值為full,否則預檢查階段提示報錯,且無法成功啟動資料同步任務。參數設定方法,請參見設定執行個體參數

      重要
      • 若源執行個體為自建MySQL,則需開啟Binlog,並且設定binlog_format為row且binlog_row_image為full。

      • 若源執行個體自建MySQL是雙主叢集(兩者互為主從),為保障DTS能擷取全部的Binlog日誌,則您需開啟參數log_slave_updates。具體操作請參見為自建MySQL建立帳號並設定binlog

    • 如為增量同步處理任務,DTS要求來源資料庫的本地Binlog日誌儲存24小時以上;如為全量同步和增量同步處理任務,DTS要求來源資料庫的本地Binlog日誌至少保留7天以上(您可在全量同步完成後將Binlog儲存時間設定為24小時以上),否則DTS可能因無法擷取Binlog而導致任務失敗,極端情況下甚至可能會導致資料不一致或丟失。由於您所設定的Binlog日誌儲存時間低於DTS要求的時間進而導致的問題,不在DTS的SLA保障範圍內。如源為RDS MySQL,具體操作請參見管理本地日誌(Binlog)

  • 在全量同步階段,請勿執行庫或表結構變更的DDL操作,否則會導致資料同步任務失敗。

  • 在同步執行個體運行期間,不記錄Binlog的變更操作所產生的資料(例如通過物理備份功能恢複、級聯操作等產生的資料),不會被同步到目標庫。

    說明

    若有該情況,您可以在業務允許的前提下,通過修改同步對象功能,移除該資料所屬的庫表,然後將該資料所屬的庫表重新添加到待同步對象。更多資訊,請參見修改同步對象

  • 若源庫為8.0.23及以後版本的MySQL資料庫,且待同步的資料中包含不可見的隱藏列,則可能會因為無法擷取該列的資料而導致資料丟失。

    說明
    • 您可以使用ALTER TABLE <table_name> ALTER COLUMN <column_name> SET VISIBLE;命令,將該隱藏列設定為可見。更多資訊,請參見Invisible Columns

    • 無主鍵的表會自動產生不可見的隱藏主鍵,您也需要將該隱藏主鍵設定為可見。更多資訊,請參見Generated Invisible Primary Keys

其他限制

  • 不支援映射功能。

  • 不支援跨地區的同步任務。

  • 執行資料同步前需評估源庫和目標庫的效能,同時建議業務低峰期執行資料同步。否則全量資料初始化時將佔用源庫和目標庫一定的讀寫資源,可能會導致資料庫的負載上升。

  • 全量初始化會並發執行INSERT操作,因此含全量同步任務的目標函數的並發度不能太小。調整函數並發度的操作,請參見設定執行個體並發度

  • 如同步對象為單個或多個表(非整庫),那麼在資料同步時,勿對源庫的同步對象使用pt-online-schema-change等類似工具執行線上DDL變更,否則會導致同步失敗。您可以使用Data Management(Data Management)來執行線上DDL變更,請參見不鎖表結構變更

  • 請避免多個DTS任務同步到同一個目標函數,建議不同任務使用不同的函數進行資料隔離,否則可能會造成目標端資料混亂。

  • 若RDS MySQL執行個體已開通全密態(EncDB)功能,則不支援全量資料同步。

  • 若執行個體運行失敗,DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中,可能會對該執行個體進行重啟、調整參數等操作。

    說明

    在調整參數時,僅會修改執行個體的參數,不會對資料庫中的參數進行修改。可能修改的參數,包括但不限於修改執行個體參數中的參數。

特殊情況

  • 當源庫為自建MySQL時:

    • 在同步時,如果源庫進行主備切換,將會導致同步任務失敗。

    • 由於DTS的延遲時間是根據同步到目標庫最後一條資料的時間戳記和目前時間戳對比得出,源庫長時間未執行DML操作可能導致延遲資訊不準確。如果任務顯示的延遲時間過大,您可以在源庫執行一個DML操作來更新延遲資訊。

      說明

      如果同步對象選擇為整庫,您還可以建立心跳錶,心跳錶每秒定期更新或者寫入資料。

    • DTS會在源庫定時執行CREATE DATABASE IF NOT EXISTS `test`命令以推進Binlog位點。

  • 當源庫為RDS MySQL時:

    不記錄交易記錄的RDS MySQL執行個體(如RDS MySQL 5.6版本的唯讀執行個體)不支援作為源庫。

費用說明

同步類型

鏈路配置費用

全量資料同步

不收費。

增量資料同步

收費,詳情請參見計費概述

支援同步的SQL操作

操作類型

SQL動作陳述式

DML

INSERT、UPDATE、DELETE

DDL

  • CREATE TABLE、ALTER TABLE、DROP TABLE、RENAME TABLE、TRUNCATE TABLE

  • CREATE VIEW、ALTER VIEW、DROP VIEW

  • CREATE PROCEDURE、ALTER PROCEDURE、DROP PROCEDURE

  • CREATE FUNCTION、DROP FUNCTION、CREATE TRIGGER、DROP TRIGGER

  • CREATE INDEX、DROP INDEX

資料庫帳號的許可權要求

資料庫

要求的權限

建立及授權方式

RDS MySQL

待同步對象的讀許可權。

建立帳號修改帳號許可權

說明

若您使用的源庫帳號不是通過RDS MySQL控制台建立且授權,您需確保該帳號具備REPLICATION CLIENT、REPLICATION SLAVE、SHOW VIEW和SELECT許可權。

操作步驟

  1. 進入目標地區的同步工作清單頁面(二選一)。

    通過DTS控制台進入

    1. 登入Data Transmission Service控制台

    2. 在左側導覽列,單擊資料同步

    3. 在頁面左上方,選擇同步執行個體所屬地區。

    通過DMS控制台進入

    說明

    實際操作可能會因DMS的模式和布局不同,而有所差異。更多資訊,請參見極簡模式控制台自訂DMS介面布局與樣式

    1. 登入Data Management服務

    2. 在頂部功能表列中,選擇整合與開發 > 資料轉送(DTS) > 資料同步

    3. 同步任務右側,選擇同步執行個體所屬地區。

  2. 單擊創建任務,進入任務配置頁面。

  3. 可選:在頁面右上方,單擊試用新版配置頁

    說明
    • 若您已進入新版配置頁(頁面右上方的按鈕為返回舊版配置頁),則無需執行此操作。

    • 新版配置頁和舊版配置頁部分參數有差異,建議使用新版配置頁。

  4. 配置源庫及目標庫資訊。

    類別

    配置

    說明

    任務名稱

    DTS會自動產生一個任務名稱,建議配置具有業務意義的名稱(無唯一性要求),便於後續識別。

    源庫資訊

    選擇已有串連資訊

    您可以按實際需求,選擇是否使用已有資料庫執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明
    • 您可以在資料連線管理頁面或新版配置頁面,將資料庫錄入DTS。更多資訊,請參見資料連線管理

    • DMS控制台的配置項為選擇DMS資料庫執行個體,您可以單擊新增DMS資料庫執行個體或在控制台首頁將資料庫錄入DMS。更多資訊,請參見雲資料庫錄入他雲/自建資料庫錄入

    資料庫類型

    選擇MySQL

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇源RDS MySQL執行個體所屬地區。

    是否跨阿里雲帳號

    本樣本為同一阿里雲帳號間的同步,選擇不跨帳號

    RDS執行個體ID

    選擇源RDS MySQL執行個體ID。

    資料庫帳號

    填入源RDS MySQL執行個體的資料庫帳號,許可權要求請參見資料庫帳號的許可權要求

    資料庫密碼

    填入該資料庫帳號對應的密碼。

    串連方式

    根據需求選擇非加密串連SSL安全連線。如果設定為SSL安全連線,您需要提前開啟RDS MySQL執行個體的SSL加密功能,詳情請參見使用雲端認證快速開啟SSL鏈路加密

    目標庫資訊

    選擇已有串連資訊

    您可以按實際需求,選擇是否使用已有資料庫執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明
    • 您可以在資料連線管理頁面或新版配置頁面,將資料庫錄入DTS。更多資訊,請參見資料連線管理

    • DMS控制台的配置項為選擇DMS資料庫執行個體,您可以單擊新增DMS資料庫執行個體或在控制台首頁將資料庫錄入DMS。更多資訊,請參見雲資料庫錄入他雲/自建資料庫錄入

    資料庫類型

    選擇Function Compute FC

    接入方式

    選擇雲執行個體

    執行個體地區

    預設與源庫執行個體地區一致,且不支援修改。

    服務

    選擇目標Function ComputeFC的服務名稱。

    函數

    選擇目標Function ComputeFC用於接收資料的函數。

    服務版本和別名

    請根據實際情況進行選擇。

    • 預設版本服務版本固定為LATEST

    • 指定版本:您還需選擇服務版本

    • 指定別名:您還需選擇服務別名

    說明

    目標Function ComputeFC的專有名詞,請參見基本概念

  5. 配置完成後,單擊頁面下方的測試連接以進行下一步

    如果源或目標資料庫是阿里雲資料庫執行個體(例如RDS MySQLApsaraDB 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網關/智能網關)的方式接入。

  6. 配置任務對象。

    1. 對象配置頁面,配置待同步的對象。

      配置

      說明

      同步類型

      固定選中增量同步處理。若您有存量資料的同步需求,您還需要同時選中全量同步

      資料格式

      同步到FC函數中的資料存放區格式,當前僅支援Canal Json

      說明

      Canal Json的參數說明和樣本,請參見Canal Json說明

      源庫對象

      源庫對象框中單擊待同步對象,然後單擊向右將其移動至已選擇對象框。

      說明

      同步對象的選擇粒度為庫或表。

      已選擇對象

      請在已選擇對象框中確認待同步的資料。

      說明

      若您需要移除已選擇的對象,可以在已選擇對象框中勾選目標對象,並單擊zuoyi進行移除。

    2. 單擊下一步高級配置,進行進階參數配置。

      配置

      說明

      選擇調度該任務的專屬叢集

      DTS預設將任務調度到共用叢集上,您無需選擇。若您希望任務更加穩定,可以購買專屬叢集來運行DTS同步任務。更多資訊,請參見什麼是DTS專屬叢集

      源庫、目標庫無法串連後的重試時間

      在同步任務啟動後,若源庫或目標庫串連失敗則DTS會報錯,並會立即進行持續的重試串連,預設持續重試時間為720分鐘,您也可以在取值範圍(10~1440分鐘)內自訂重試時間,建議設定30分鐘以上。如果DTS在設定的重試時間內重新串連上源庫、目標庫,同步任務將自動回復。否則,同步任務將會失敗。

      說明
      • 針對同源或者同目標的多個DTS執行個體,如DTS執行個體A和DTS執行個體B,設定網路重試時間時A設定30分鐘,B設定60分鐘,則重試時間以低的30分鐘為準。

      • 由於串連重試期間,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

      監控警示

      是否設定警示,當同步失敗或延遲超過閾值後,將通知警示連絡人。

  7. 儲存任務並進行預檢查。

    • 若您需要查看調用API介面配置該執行個體時的參數資訊,請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上,然後單擊氣泡中的預覽OpenAPI參數

    • 若您無需查看或已完成查看API參數,請單擊頁面下方的下一步儲存任務並預檢查

    說明
    • 在同步作業正式啟動之前,會先進行預檢查。只有預檢查通過後,才能成功啟動同步作業。

    • 如果預檢查失敗,請單擊失敗檢查項後的查看詳情,並根據提示修複後重新進行預檢查。

    • 如果預檢查產生警告:

      • 對於不可以忽略的檢查項,請單擊失敗檢查項後的查看詳情,並根據提示修複後重新進行預檢查。

      • 對於可以忽略無需修複的檢查項,您可以依次單擊點擊確認警示詳情確認屏蔽確定重新進行預檢查,跳過警示檢查項重新進行預檢查。如果選擇屏蔽警示檢查項,可能會導致資料不一致等問題,給業務帶來風險。

  8. 購買執行個體。

    1. 預檢查通過率顯示為100%時,單擊下一步購買

    2. 購買頁面,選擇資料同步執行個體的計費方式、鏈路規格,詳細說明請參見下表。

      類別

      參數

      說明

      資訊配置

      計費方式

      • 預付費(訂用帳戶):在建立執行個體時支付費用。適合長期需求,價格比隨用隨付更實惠,且購買時間長度越長,折扣越多。

      • 後付費(隨用隨付):按小時計費。適合短期需求,用完可立即釋放執行個體,節省費用。

      資源群組配置

      執行個體所屬的資源群組,預設為default resource group。更多資訊,請參見什麼是資源管理

      鏈路規格

      DTS為您提供了不同效能的同步規格,同步鏈路規格的不同會影響同步速率,您可以根據業務情境進行選擇。更多資訊,請參見資料同步鏈路規格說明

      訂購時間長度

      在預付費模式下,選擇訂用帳戶執行個體的時間長度和數量,包月可選擇1~9個月,包年可選擇1年、2年、3年和5年。

      說明

      該選項僅在付費類型為預付費時出現。

    3. 配置完成後,閱讀並勾選《資料轉送(隨用隨付)服務條款》

    4. 單擊購買並啟動,並在彈出的確認對話方塊,單擊確定

      您可在資料同步介面查看具體任務進度。

後續步驟

目標服務接收的資料格式

FC接收到的資料類型為Object,源端增量資料以數組的方式儲存在Records欄位中,數組中的每一個元素為一條Object類型的資料記錄。其中Object欄位和含義如下表所示。

說明

FC接收到的資料有DML和DDL兩種:

  • DDL:記錄更改資料庫的結構資訊。

  • DML:記錄管理資料庫中的資料資訊。

欄位

類型

說明

isDdl

Boolean

是否為DDL操作。

  • True:是。

  • False:否。

type

String

SQL操作的類型。

  • DML操作:DELETEUPDATEINSERT

  • DDL操作:固定為DDL

重要

全量任務階段固定為INIT

database

String

MySQL的資料庫名。

table

String

MySQL的表名。

pkNames

String

MySQL表的主鍵名。

es

Long

操作在源庫的執行時間,13位Unix時間戳記,單位為毫秒。

說明

Unix時間戳記轉換工具可用搜尋引擎擷取。

ts

Long

操作開始寫入到目標庫的時間,13位Unix時間戳記,單位為毫秒。

說明

Unix時間戳記轉換工具可用搜尋引擎擷取。

data

Object Array

Array中僅包含一個元素,類型為Object,其中Key為列名,value為對應的值。

old

Object Array

儲存更新前的資料,格式同 data 欄位。

重要

僅當typeDELETE時存在,格式與data欄位相同。

sql

String

  • type為DML(即DELETEUPDATEINSERT)時值為空白。

  • typeDDL時,表示執行的SQL語句。

id

Int

操作的序號。

DDL操作資料格式樣本

ALTER TABLE操作

SQL語句

ALTER TABLE `demoTable` 
	ADD COLUMN `address` varchar(20) NULL AFTER `sex`
;

FC接收到的資料

{
	'Records': [{
		'type': 'DDL',
		'serverId': '27142679',
		'es': 1690000000000,
		'sql': '/* Query from DMS-WEBSQL-0-Eid_15682857722282385K by user 14xxxxxxxx */ ALTER TABLE `demoDatabase`.`DDL` \n\tADD COLUMN `address` varchar(20) NULL AFTER `sex`',
		'database': 'demoDatabase',
		'id': 63151,
		'isDdl': True,
		'table': 'demoTable',
		'ts': 1690000000000
	}]
}

DML操作資料格式樣本

插入資料

SQL語句

INSERT INTO demoTable VALUES("xiaoming", 10, "man");

FC接收到的資料

{
	'Records': [{
		'data': [{
			'sex': 'man',
			'name': 'xiaoming',
			'age': '10'
		}],
		'pkNames': ['name'],
		'type': 'INSERT',
		'serverId': '27142678',
		'es': 1690000000000,
		'sql': '',
		'database': 'demoDatabase',
		'sqlType': {
			'sex': 253,
			'name': 253,
			'age': 3
		},
		'mysqlType': {
			'sex': 'varchar',
			'name': 'varchar',
			'age': 'int'
		},
		'id': 62051,
		'isDdl': False,
		'table': 'demoTable',
		'ts': 1690000000000
	}]
}

更新資料

SQL語句

UPDATE `demoDatabase`.`demoTable` SET `age`=11 WHERE `name`='xiaoming';

FC接收到的資料

{
	'Records': [{
		'data': [{
			'sex': 'man',
			'name': 'xiaoming',
			'age': '11'
		}],
		'pkNames': ['name'],
		'old': [{
			'sex': 'man',
			'name': 'xiaoming',
			'age': '10'
		}],
		'type': 'UPDATE',
		'serverId': '27142679',
		'es': 1690000000000,
		'sql': '',
		'database': 'demoDatabase',
		'sqlType': {
			'sex': 253,
			'name': 253,
			'age': 3
		},
		'mysqlType': {
			'sex': 'varchar',
			'name': 'varchar',
			'age': 'int'
		},
		'id': 62373,
		'isDdl': False,
		'table': 'demoTable',
		'ts': 1690000000000
	}]
}

刪除資料

SQL語句

DELETE FROM `demoDatabase`.`demoTable` WHERE `name`='xiaoming';

FC接收到的資料

{
	'Records': [{
		'data': [{
			'sex': 'man',
			'name': 'xiaoming',
			'age': '11'
		}],
		'pkNames': ['name'],
		'type': 'DELETE',
		'serverId': '27142679',
		'es': 1690000000000,
		'sql': '',
		'database': 'demoDatabase',
		'sqlType': {
			'sex': 253,
			'name': 253,
			'age': 3
		},
		'mysqlType': {
			'sex': 'varchar',
			'name': 'varchar',
			'age': 'int'
		},
		'id': 62635,
		'isDdl': False,
		'table': 'demoTable',
		'ts': 1690000000000
	}]
}