摘要:作者張學程本文為源碼閱讀系列文章的第二篇,第一篇文章簡單介紹了源碼閱讀的目的和規劃,以及的源碼結構以及工具鏈。通過注冊,并將該作為各的。在本篇文章中,我們暫時只關注架構相關的實現,上述各功能的具體實現將在后續的相關文章中展開介紹。
作者:張學程
本文為 DM 源碼閱讀系列文章的第二篇,第一篇文章 簡單介紹了 DM 源碼閱讀的目的和規劃,以及 DM 的源碼結構以及工具鏈。從本篇文章開始,我們會正式開始閱讀 DM 的源碼。
本篇文章主要介紹 DM 的整體架構,包括 DM 有哪些組件、各組件分別實現什么功能、組件之間交互的數據模型和 RPC 實現。
整體架構通過上面的 DM 架構圖,我們可以看出,除上下游數據庫及 Prometheus 監控組件外,DM 自身有 DM-master、DM-worker 及 dmctl 這 3 個組件。其中,DM-master 負責管理和調度數據同步任務的各項操作,DM-worker 負責執行具體的數據同步任務,dmctl 提供用于管理 DM 集群與數據同步任務的各項命令。
DM-masterDM-master 的入口代碼在 cmd/dm-master/main.go,其中主要操作包括:
調用 cfg.Parse 解析命令行參數與參數配置文件
調用 log.SetLevelByString 設置進程的 log 輸出級別
調用 signal.Notify 注冊系統 signal 通知,用于接受到指定信號時退出進程等
調用 server.Start 啟動 RPC server,用于響應來自 dmctl 與 DM-worker 的請求
在上面的操作中,可以看出其中最關鍵的是步驟 4,其對應的實現代碼在 dm/master/server.go 中,其核心為 Server 這個 struct,其中的主要 fields 包括:
rootLis, svr:監聽網絡連接,分發 RPC 請求給對應的 handler。
workerClients:維護集群各 DM-worker ID 到對應的 RPC client 的映射關系。
taskWorkers:維護用于執行各同步(子)任務的 DM-worker ID 列表。
lockKeeper:管理在協調處理 sharding DDL 時的 lock 信息。
sqlOperatorHolder:管理手動 skip/replace 指定 sharding DDL 時的 SQL operator 信息。
在本篇文章中,我們暫時不會關注 lockKeeper 與 sqlOperatorHolder,其具體的功能與代碼實現會在后續相關文章中進行介紹。
在 DM-master Server 的入口方法 Start 中:
通過 net.Listen 初始化 rootLis 并用于監聽 TCP 連接(借助 soheilhy/cmux,我們在同一個 port 同時提供 gRPC 與 HTTP 服務)。
根據讀取的配置信息(DeployMap),初始化用于連接到各 DM-worker 的 RPC client 并保存在 workerClients 中。
通過 pb.RegisterMasterServer 注冊 gRPC server(svr),并將該 Server 作為各 services 的 implementation。
調用 m.Serve 開始提供服務。
DM-master 提供的 RPC 服務包括 DM 集群管理、同步任務管理等,對應的 service 以 Protocol Buffers 格式定義在 dm/proto/dmmaster.proto 中,對應的 generated 代碼在 dm/pb/dmmaster.pb.go 中。各 service 的具體實現在 dm/master/server.go 中(*Server)。
DM-workerDM-worker 的結構與 DM-master 類似,其入口代碼在 cmd/dm-worker/main.go 中。各 RPC services 的 Protocol Buffers 格式定義在 dm/proto/dmworker.proto 中,對應的 generated 代碼在 dm/pb/dmworker.pb.go 中,對應的實現代碼在 dm/worker/server.go 中(*Server)。DM-worker 的啟動流程與 DM-master 類似,在此不再額外說明。
Server 這個 struct 的主要 fields 除用于處理 RPC 的 rootLis 與 svr 外,另一個是用于管理同步任務與 relay log 的 worker(相關代碼在 dm/worker/worker.go 中)。
在 Worker 這個 struct 中,主要 fields 包括:
subTasks:維護該 DM-worker 上的所有同步子任務信息。
relayHolder:對 relay 處理單元相關操作進行簡單封裝,轉發相關操作請求給 relay 處理單元,獲取 relay 處理單元的狀態信息。
relayPurger:根據用戶配置及相關策略,嘗試定期對 relay log 進行 purge 操作。
數據同步子任務管理的代碼實現主要在 dm/worker/subtask.go 中, relay 處理單元管理的代碼實現主要在 dm/worker/relay.go 中,對 relay log 進行 purge 操作的代碼實現主要在 relay/purger pkg 中。在本篇文章中,我們暫時只關注 DM 架構相關的實現,上述各功能的具體實現將在后續的相關文章中展開介紹。
Worker 的入口方法為 Start,其中的主要操作包括:
通過 w.relayHolder.Start 啟動 relay 處理單元,開始從上游拉取 binlog。
通過 w.relayPurger.Start 啟動后臺 purge 線程,嘗試對 relay log 進行定期 purge。
其他的操作主要還包括處理 Server 轉發而來的同步任務管理、relay 處理單元管理、狀態信息查詢等。
dmctldmctl 的入口代碼在 cmd/dm-ctl/main.go,其操作除參數解析與 signal 處理外,主要為調用 loop 進入命令處理循環、等待用戶輸入操作命令。
在 loop 中,我們借助 chzyer/readline 提供命令行交互環境,讀取用戶輸入的命令并輸出命令執行結果。一個命令的處理流程為:
調用 l.Readline 讀取用戶輸入的命令
判斷是否需要退出命令行交互環境(exit 命令)或需要進行處理
調用 ctl.Start 進行命令分發與處理
dmctl 的具體命令處理實現在 dm/ctl pkg 中,入口為 dm/ctl/ctl.go 中的 Start 方法,命令的分發與參數解析借助于 spf13/cobra。命令的具體功能實現在相應的子 pkg 中:
master:dmctl 與 DM-master 交互的命令,是當前 DM 推薦的命令交互方式。
worker:dmctl 與 DM-worker 交互的命令,主要用于開發過程中進行 debug,當前并沒有實現所有 DM-worker 支持的命令,未來可能廢棄。
common:多個命令依賴的通用操作及 dmctl 依賴的配置信息等。
每個 dmctl 命令,其主要對應的實現包括 3 個部分:
在各命令對應的實現源文件中,通過 New***Cmd 形式的方法創建 cobra.Command 對象。
在 dm/ctl/ctl.go 中通過調用 rootCmd.AddCommand 添加該命令。
在各命令對應的實現源文件中,通過 ***Func 形式的方法實現參數驗證、RPC 調用等具體功能。
任務管理調用鏈示例讓我們用一個啟動數據同步任務的操作示例來說明 DM 中的組件交互與 RPC 調用流程。
用戶在 dmctl 命令行交互環境中輸入 start-task 命令及相應參數。
dmctl 在 dm/ctl/ctl.go 的 Start 方法中進行命令分發,請求 dm/ctl/master/start_task.go 中的 startTaskFunc 處理命令。
startTaskFunc 通過 cli.StartTask 調用 DM-master 上的 RPC 方法。
DM-master 中的 Server.StartTask 方法(dm/master/server.go)響應來自 dmctl 的 RPC 請求。
Server.Start 從 workerClients 中獲取任務對應 DM-worker 的 RPC client,并通過 cli.StartSubTask 調用 DM-worker 上的 RPC 方法。
DM-worker 中的 Server.StartSubTask 方法(dm/worker/server.go)響應來自 DM-master 的 RPC 請求。
Server.StartSubTask 中將任務管理請求轉發給 Worker.StartSubTask(dm/worker/worker.go),并將處理結果通過 RPC 返回給 DM-master。
DM-master 將 DM-worker 返回的 RPC 響應重新封裝后通過 RPC 返回給 dmctl。
dmctl 通過 common.PrettyPrintResponse 輸出命令操作的 RPC 響應。
小結在本篇文章中,我們主要介紹了 DM 的各個組件的入口函數,最后以 dmctl 的 start-task 為例介紹了交互的調用流程細節。下一篇文章我們會開始介紹 DM-worker 組件內各數據同步處理單元(relay-unit, dump-unit, load-unit, sync-unit)的設計原理與具體實現。
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://m.specialneedsforspecialkids.com/yun/17957.html
摘要:內容概要源碼閱讀系列將會從兩條線進行展開,一條是圍繞的系統架構和重要模塊進行分析,另一條線圍繞內部的同步機制展開分析。更多的代碼閱讀內容會在后面的章節中逐步展開,敬請期待。 作者:楊非 前言 TiDB-DM 是由 PingCAP 開發的一體化數據同步任務管理平臺,支持從 MySQL 或 MariaDB 到 TiDB 的全量數據遷移和增量數據同步,在 TiDB DevCon 2019 正...
閱讀 2790·2023-04-26 01:47
閱讀 3599·2023-04-25 23:45
閱讀 2476·2021-10-13 09:39
閱讀 613·2021-10-09 09:44
閱讀 1802·2021-09-22 15:59
閱讀 2779·2021-09-13 10:33
閱讀 1728·2021-09-03 10:30
閱讀 664·2019-08-30 15:53