Canal 實戰 | 第一篇:SpringBoot 整合 Canal + RabbitMQ 實現監聽 MySQL 資料庫同步更新 Redis 快取

有來技術團隊發表於2021-11-08

一. Canal 簡介

canal [kə'næl],譯意為水道/管道/溝渠,主要用途是基於 MySQL 資料庫增量日誌解析,提供增量資料訂閱和消費

早期阿里巴巴因為杭州和美國雙機房部署,存在跨機房同步的業務需求,實現方式主要是基於業務 trigger 獲取增量變更。從 2010 年開始,業務逐步嘗試資料庫日誌解析獲取增量變更進行同步,由此衍生出了大量的資料庫增量訂閱和消費業務。

基於日誌增量訂閱和消費的業務包括

  • 資料庫映象
  • 資料庫實時備份
  • 索引構建和實時維護(拆分異構索引、倒排索引等)
  • 業務 cache 重新整理
  • 帶業務邏輯的增量資料處理

當前的 canal 支援源端 MySQL 版本包括 5.1.x , 5.5.x , 5.6.x , 5.7.x , 8.0.x

二. Canal 工作原理

1. MySQL主備複製原理

  • MySQL master 將資料變更寫入二進位制日誌( binary log, 其中記錄叫做二進位制日誌事件binary log events,可以通過 show binlog events 進行檢視)
  • MySQL slave 將 master 的 binary log events 拷貝到它的中繼日誌(relay log)
  • MySQL slave 重放 relay log 中事件,將資料變更反映它自己的資料

2. Canal 工作原理

  • Canal 模擬 MySQL slave 的互動協議,偽裝自己為 MySQL slave ,向 MySQL master 傳送dump 協議

  • MySQL master 收到 dump 請求,開始推送 binary log 給 slave (即 canal )

  • Canal 解析 binary log 物件(原始為 byte 流)

三. Canal 實戰

1. 需求分析

有來專案 youlai-mall 當前進度下使用Redis快取MySQL資料庫中的OAuth2客戶端資訊、角色許可權對映關係、選單路由,現在這樣有兩個很明顯的問題:

  1. 在後臺管理介面修改角色、選單、許可權和OAuth2客戶端任何一方資訊都需要讓快取失效或者更新快取,程式碼耦合性高;
  2. 資料庫直接修改上面相關資訊,快取無法失效或更新。

第一種情況至少有解決方案,無非就在程式碼層面上清快取或者更新快取,但是如果是直接修改資料庫呢?實際工作可能經常會遇到直接修改資料庫的場景,本篇通過SpringBoot 整合 Canal + RabbitMQ 實現對資料庫的監聽然後同步讓快取失效或者更新。當然有來專案引入 Canal 中介軟體重新整理快取只是個開始,接下來還會使用 Canal 同步商品表至 ElasticSearch。

2. MySQL開啟 binlog 日誌

MySQL 部署https://www.cnblogs.com/haoxianrui/p/15488810.html

開啟 biglog 日誌

vim /etc/my.cnf

新增配置

[mysqld]
log-bin=mysql-bin # 開啟binlog
binlog-format=ROW # 選擇ROW模式
server_id=1 # 配置MySQL replaction需要定義,不和Canal的slaveId重複即可

重啟MySQL ,檢視配置是否生效

show variables like 'log_bin';

image-20211031132004048

3. RabbitMQ 佇列建立

  • 新增交換機 canal.exchange

image-20211106155345574

  • 新增佇列 canal.queue

  • 佇列繫結交換機

image-20211106171049407

image-20211106171220841

4. Canal 配置和啟動

Canal Server下載

進入下載地址,選擇 canal.deployer-1.1.5.tar.gz

image-20211106172307548

將壓縮包解壓,我這裡把最後解壓出來的檔案放入 有來專案 的middleware中介軟體檔案,和之前的 nacos 和 sentinel 同一個套路。

image-20211106180719409

Canal Server配置

需要配置的東西就兩項,一個是監聽資料庫配置,另一個是 RabbitMQ 連線配置。

改動的兩個檔案分別是 Canal 配置檔案 canal.properties 和 例項配置檔案 instance.properties

㊙️:一個 Server 可以配置多個例項監聽 ,Canal 功能預設自帶的有個 example 例項,本篇就用 example 例項 。如果增加例項,複製 example 資料夾內容到同級目錄下,然後在 canal.properties 指定新增例項的名稱。

image-20211106195506494

  • canal.properties

    配置 Canal 服務方式為 RabbitMQ 和連線配置(?️ 只列出需要修改的地方)

    # tcp, kafka, rocketMQ, rabbitMQ
    canal.serverMode = rabbitMQ
    ##################################################
    ######### 		    RabbitMQ	     #############
    ##################################################
    rabbitmq.host = x.youlai.tech
    rabbitmq.virtual.host =/
    rabbitmq.exchange =canal.exchange
    rabbitmq.username =guest
    rabbitmq.password =guest
    rabbitmq.deliveryMode =
    
  • instance.properties

    監聽資料庫配置(?️ 只列出需要修改的地方)

    # position info
    canal.instance.master.address=x.youlai.tech:3306
    # username/password
    canal.instance.dbUsername=root
    canal.instance.dbPassword=root
    # mq config
    canal.mq.topic=canal.routing.key
    

5. SpringBoot 整合 Canal + RabbitMQ

? 完整原始碼:https://gitee.com/youlaitech/youlai-mall

引入依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>

RabbitMQ連線配置

spring:
  rabbitmq:
    host: x.youlai.tech
    port: 5672
    username: guest
    password: guest

RabbitMQ 監聽同步快取

/**
 * Canal + RabbitMQ 監聽資料庫資料變化
 *
 * @author <a href="mailto:xianrui0365@163.com">haoxr</a>
 * @date 2021/11/4 23:14
 */
@Component
@Slf4j
@RequiredArgsConstructor
public class CanalListener {

    private final ISysPermissionService permissionService;
    private final ISysOauthClientService oauthClientService;
    private final ISysMenuService menuService;

    @RabbitListener(bindings = {
            @QueueBinding(
                    value = @Queue(value = "canal.queue", durable = "true"),
                    exchange = @Exchange(value = "canal.exchange"),
                    key = "canal.routing.key"
            )
    })
    public void handleDataChange(String message) {
        CanalMessage canalMessage = JSONUtil.toBean(message, CanalMessage.class);
        String tableName = canalMessage.getTable();

        log.info("Canal 監聽 {} 發生變化;明細:{}", tableName, message);

        if ("sys_oauth_client".equals(tableName)) {
            log.info("======== 清除客戶端資訊快取 ========");
            oauthClientService.cleanCache();
        } else if (Arrays.asList("sys_permission", "sys_role", "sys_role_permission").contains(tableName)) {
            log.info("======== 重新整理角色許可權快取 ========");
            permissionService.refreshPermRolesRules();
        } else if (Arrays.asList("sys_menu", "sys_role", "sys_role_menu").contains(tableName)) {
            log.info("======== 清理選單路由快取 ========");
            menuService.cleanCache();
        }
    }
}

6. 實戰測試

?️ 如果使用有來專案線上 RabbitMQ 測試,記得需要新建佇列,否者多人消費同一佇列會讓你覺得 Canal 監聽資料有丟失的現象。

接下來模擬測試,當直接在資料庫修改選單資料,能否讓 Redis 的選單路由快取失效。

啟動 Canal

切換到專案的 cd ./middleware/canal/deployer/bin startup 目錄下,輸入 startup 啟動 Canal

image-20211108005901414

啟動 youlai-admin 應用,測試效果如下,可見最後選單路由快取在直接在資料庫修改選單表資料時會失效,達到預期效果。

canalmq

四. 總結

本篇通過 Canal + RabbitMQ 實現對 MySQL 資料變動監聽,能夠應對實際工作直接修改資料庫資料後讓快取失效或者重新整理的場景。有來專案引入 Canal 本篇只是個開始,因為 Canal 的應用場景太豐富了,接下來有來專案使用 Canal 同步 MySQL 資料庫的商品資料至 ElasticSearch 索引庫,個人感覺以後會越來越火,所以建議有必要深入瞭解這個 Canal 框架。

五. 聯絡資訊

有興趣進交流群的童鞋歡迎加群, 純屬學習交流群,無任何利益,二維碼過期可加我微信備註“有來”即可,我拉你進群,另外如果有興趣加入開源專案 youlai-mall 開發的歡迎私信我。

有來②群二維碼 【有來小店】微信小程式體驗碼 我的微信
Canal 實戰 | 第一篇:SpringBoot 整合 Canal + RabbitMQ 實現監聽 MySQL 資料庫同步更新 Redis 快取

相關文章