0


Alibaba Canal数据同步 mysql->mysql

1.前言

我们都知道一个系统最重要的是数据,数据是保存在数据库里。但是很多时候不单止要保存在数据库中,还要同步保存到Elastic Search、HBase、Redis等等。

这时我注意到阿里开源的框架Canal,他可以很方便地同步数据库的增量数据到其他的存储应用。所以在这里总结一下,分享给各位读者参考~

2.什么是canal

我们先看官网的介绍:

canal,译意为水道/管道/沟渠,主要用途是基于 MySQL *数据库增量日志解析,提供*增量数据订阅和消费

这句介绍有几个关键字:增量日志,增量数据订阅和消费

这里我们可以简单地把canal理解为一个用来同步增量数据的一个工具

canal的工作原理就是把自己伪装成MySQL slave,模拟MySQL slave的交互协议向MySQL Mater发送** dump协议,MySQL mater收到canal发送过来的dump请求,开始推送binary logcanal,然后canal解析binary log**,再发送到存储目的地,比如MySQL,Kafka,Elastic Search等等。

3.canal能做什么

与其问canal能做什么,不如说数据同步有什么作用。

但是canal的数据同步不是全量的,而是增量。基于binary log增量订阅和消费,canal可以做:

  • 数据库镜像
  • 数据库实时备份
  • 索引构建和实时维护
  • 业务cache(缓存)刷新
  • 带业务逻辑的增量数据处理

4.如何搭建canal

4.1首先有一个MySQL服务器

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

我的Linux服务器安装的MySQL服务器是5.7版本。

MySQL的安装这里就不演示了,比较简单,网上也有很多教程。

然后在MySQL中需要创建一个用户,并授权:

-- 使用命令登录:mysql -u root -p
-- 创建用户 用户名:canal 密码:Canal@123456
create user 'canal'@'%' identified by 'Canal@123456';
-- 授权 *.*表示所有库
grant SELECT, REPLICATION SLAVE, REPLICATION CLIENT on *.* to 'canal'@'%' identified by 'Canal@123456';

下一步在MySQL配置文件my.cnf设置如下信息:

[mysqld]
# 打开binlog
log-bin=mysql-bin
# 选择ROW(行)模式
binlog-format=ROW
# 配置MySQL replaction需要定义,不要和canal的slaveId重复
server_id=1

4.2 准备canal

1.下载

去官网下载页面进行下载:https://github.com/alibaba/canal/releases

2.解压

3.修改配置文件

需要配置以下参数:

#canal读取mysql的binlog文件是把自己伪装成一个slava ,所以需要配置一个id,这个id不能和mysql配置的id相同

canal.instance.mysql.slaveId=9

#要监听的mysql的地址

canal.instance.master.address=127.0.0.1:3306

#mysql 数据解析关注的表,Perl正则表达式.

#多个正则之间以逗号(,)分隔,转义符需要双斜杠(\)

#常见例子:

#1. 所有表:.* or .\..

#2. canal schema下所有表:canal\..*

#3. canal下的以canal打头的表:canal\.canal.*

#4. canal schema下的一张表:canal.test1

#5. 多个规则组合使用:canal\..*,mysql.test1,mysql.test2 (逗号分隔)

#默认监听的数据库的名称,也可以不配置这个

canal.instance.defaultDatabaseName=test

#黑名单

canal.instance.filter.black.regex=mysql\.slave_.*

#白名单

canal.instance.filter.regex=.\..

4.启动canal

  1. 查看配置,是否有报错

5.Java创建客户端,监听canalServer(官网推荐方式)

1.创建SpringBoot项目

略过…

2.导入canal客户端包

<*dependency*>
<*groupId*>com.alibaba.otter</*groupId*>
<*artifactId*>canal.client</*artifactId*>
<*version*>1.1.5</*version*>
</*dependency*>

3.导入测试Main方法

import com.alibaba.otter.canal.client.CanalConnector;

import com.alibaba.otter.canal.client.CanalConnectors;

import com.alibaba.otter.canal.common.utils.AddressUtils;

import com.alibaba.otter.canal.protocol.CanalEntry.Column;

import com.alibaba.otter.canal.protocol.CanalEntry.Entry;

import com.alibaba.otter.canal.protocol.CanalEntry.EntryType;

import com.alibaba.otter.canal.protocol.CanalEntry.EventType;

import com.alibaba.otter.canal.protocol.CanalEntry.RowChange;

import com.alibaba.otter.canal.protocol.CanalEntry.RowData;

import com.alibaba.otter.canal.protocol.Message;

import java.net.InetSocketAddress;

import java.util.List;

public class ClientSample {

public static void main(String args[]) {

    // 创建链接

    CanalConnector connector = CanalConnectors.newSingleConnector(new InetSocketAddress(AddressUtils.getHostIp(),

            11111), "example", "", "");

    int batchSize = 1000;

    int emptyCount = 0;

    try {

        connector.connect();

        connector.subscribe(".*\\..*");

        connector.rollback();

        int totalEmtryCount = 1200;

        while (emptyCount < totalEmtryCount) {

            Message message = connector.getWithoutAck(batchSize); // 获取指定数量的数据

            long batchId = message.getId();

            int size = message.getEntries().size();

            if (batchId == -1 || size == 0) {

                emptyCount++;

                System.out.println("empty count : " + emptyCount);

                try {

                    Thread.sleep(1000);

                } catch (InterruptedException e) {

                    e.printStackTrace();

                }

            } else {

                emptyCount = 0;

                // System.out.printf("message[batchId=%s,size=%s] \n", batchId, size);

                printEntry(message.getEntries());

            }

            connector.ack(batchId); // 提交确认

            // connector.rollback(batchId); // 处理失败, 回滚数据

        }

        System.out.println("empty too many times, exit");

    } finally {

        connector.disconnect();

    }

}

private static void printEntry( List<Entry> entrys) {

    for (Entry entry : entrys) {

        if (entry.getEntryType() == EntryType.TRANSACTIONBEGIN || entry.getEntryType() == EntryType.TRANSACTIONEND) {

            continue;

        }

        RowChange rowChage = null;

        try {

            rowChage = RowChange.parseFrom(entry.getStoreValue());

        } catch (Exception e) {

            throw new RuntimeException("ERROR ## parser of eromanga-event has an error , data:" + entry.toString(),

                    e);

        }

        EventType eventType = rowChage.getEventType();

        System.out.println(String.format("================> binlog[%s:%s] , name[%s,%s] , eventType : %s",

                entry.getHeader().getLogfileName(), entry.getHeader().getLogfileOffset(),

                entry.getHeader().getSchemaName(), entry.getHeader().getTableName(),

                eventType));

        for (RowData rowData : rowChage.getRowDatasList()) {

            if (eventType == EventType.DELETE) {

                printColumn(rowData.getBeforeColumnsList());

            } else if (eventType == EventType.INSERT) {

                printColumn(rowData.getAfterColumnsList());

            } else {

                System.out.println("-------> before");

                printColumn(rowData.getBeforeColumnsList());

                System.out.println("-------> after");

                printColumn(rowData.getAfterColumnsList());

            }

        }

    }

}

private static void printColumn( List<Column> columns) {

    for (Column column : columns) {

        System.out.println(column.getName() + " : " + column.getValue() + "    update=" + column.getUpdated());

    }

}

}

6.Java创建客户端,GitHub推荐三方工具

1.创建SpringBoot项目

省略..

2.导入依赖

<*dependency*>
<*groupId*>top.javatool</*groupId*>
<*artifactId*>canal-spring-boot-starter</*artifactId*>
<*version*>1.2.1-RELEASE</*version*>
</*dependency*>

3.导入Bean代码

import com.brs.canalclient.domain.School;
import org.springframework.stereotype.Component;
import top.javatool.canal.client.annotation.CanalTable;
import top.javatool.canal.client.handler.EntryHandler;

import java.util.HashMap;

@CanalTable*("school") //需要监听的表
@Component
public class SchoolHandler implements EntryHandler
<School*> {
//指定表关系实体类
@Override
public void insert
(School School) {
System.out.println(
"插入数据");
//新增数据时执行此方法
}
@Override
public void update
(School before, School after) {
System.out.println(
"修改数据");
//更新数据时执行此方法
}
@Override
public void delete
(School School) {
System.out.println(
"删除数据");
//删除数据时执行此方法
}
}

4.启动项目

省略..

7.canal-adapter同步数据

详细配置教学:https://blog.csdn.net/zcl111/article/details/119868846

7.1.安装adapter客户端

https://github.com/alibaba/canal/releases

7.2解压到纯英文路径,中文会报错

7.3配置application.yml

        1. 修改标记的4个地方:

#↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ adapter适配器基础配置 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

server:

port: 8081 #

spring:

jackson:

date-format: yyyy-MM-dd HH:mm:ss

time-zone: GMT+8

default-property-inclusion: non_null

#↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ canal服务端地址 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

canal.conf:

kafka rocketMQ

mode: tcp

canalServerHost: 127.0.0.1:11111 # 2.canalService 地址

zookeeperHosts: slave1:2181

mqServers: 127.0.0.1:9092 #or rocketmq

flatMessage: true

batchSize: 500

syncBatchSize: 1000

retries: 0

timeout:

accessKey:

secretKey:

#↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ canal监控的数据源 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

srcDataSources:

source1:                                                        # 3.监控地址

  url: jdbc:mysql://localhost:3306/test?useUnicode=true

  username: root

  password: 123456yts

 

 

 

 

 

 

#↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ 数据去处时适配器配置。可以配置多个,并发执行。每个适配器都有个对应的instance。 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

canalAdapters: # 同步数据的目标数据源配置

  • instance: example # canal instance Name or mq topic name #canalServer的实例名称,或者mq交换机类型

    groups: # 消费组其一的ID

    • groupId: g1 # 消费者 group_01 下的多个数据去处 适配器。

      outerAdapters: # 组内的适配器是串行处理。如果其中一个异常,会导致下面的的适配器不能执行。

      • name: rdb # 适配器类型。即目前支持的通过SPI加载的适配器。从 plugin文件夹中读取的。

        key: adapterTestKey1 # 适配器key。具体适配器yml中配置 outerAdapterKey引用。

        properties: # 4.目标地址

        jdbc.driverClassName: com.mysql.jdbc.Driver

        jdbc.url: jdbc:mysql://localhost:3307/test?useUnicode=true

        jdbc.username: root

        jdbc.password: 123456yts

7.4mysql-》mysql需要修改 rdb配置文件

dataSourceKey: source1 ##canal adapter配置的数据源

destination: example #canal实例名称,对应application.yml中的instance

groupId: g1 #对应哪个outerAdapter的消费组

outerAdapterKey: adapterTestKey1 #application.yml 中配置的Key

concurrent: true #是否并行同步

dbMapping: #上下游数据映射

#mirrorDb: true #同步数据库DDL语句create-drop-alert,同步DDL必须配置这个

database: test #上游数据库名称

table: school #上游数据库中的表名称

targetTable: test.school #下游目标数据库+表名称 用 . 号连接

targetPk: #目标主键 primaryKey 映射

id: id                                  #ID映射

#mapAll: true # 是否整表映射, 要求源表和目标表字段名一模一样 (如果targetColumns也配置了映射,则以targetColumns配置为准)

                                        # 注意 这段表述“以targetColumns配置为准”。这个并不是说只同步 targetColumns配置的属性。而是说一样要同步 源表的所有属性。

                                        # 但是考虑到目标表的属性名称可能不完全一致,有区别的属性名称可以通过targetColumns来配置映射关系,没有配置的默认属性默认都是相同。

                                        # 如果只需要同步部分源表的属性到目标表中,这里应该设置false

targetColumns: #2. 这也是映射,如果和上面 mapAll 同时开启,targetColumns优先级更高

                                        # 字段映射, 格式: 目标表字段: 源表字段, 如果字段名一样源表字段名可不填

                                        # 注意数据源的 to: from 前面是数据要同步到的地方,后面是数据来源的

id:

school_name: name

etlCondition: "where c_time>={}"

commitBatch: 3000 # 批量提交的大小

7.5全量同步

1.上面讲解的都是增量同步的方式

     增量同步其实很简单,只用发送一条etl 请求就可以了

http://127.0.0.1:8081/etl/rdb/adapterTestKey1/mytest_user.yml

标记①:这里是动态配置的,如果CanalAdapter的配置文件中

配置了①标记出的key在etl的连接中就要加上这个eky

图1标记②:这个是同步的类型,我们现在执行的是mysql->mysql 所以是rdb

7.6多表同步

1.思路:

     每一张表的同步在canal-adapter里面多需要一个适配器

2.配置适配器

在application.yml 中配置

3.使用适配器

适配器的使用,就是指定从哪里同步到哪里了

修改复制的hobby_user.yml内容

4.配置好了直接重启 adapter服务

如果要全量同步,就通过每张表配置适配器时候指定的outerAdapterKey 来同步

8.报错解决

8.1 canal服务端

** 8.1.1:找不到表**

Caused by: java.io.IOException: ErrorPacket [errorNumber=1146, fieldCount=-1, message=Table 'xzw.BASE TABLE' doesn't exist, sqlState=42S02, sqlStateMarker=#]

with command: show create table xzw.t_1;show create table xzw.BASE TABLE;

    at com.alibaba.otter.canal.parse.driver.mysql.MysqlQueryExecutor.queryMulti(MysqlQueryExecutor.java:109) ~[canal.parse.driver-1.1.6.jar:na]

    at com.alibaba.otter.canal.parse.inbound.mysql.MysqlConnection.queryMulti(MysqlConnection.java:111) ~[canal.parse-1.1.6.jar:na]

    at com.alibaba.otter.canal.parse.inbound.mysql.tsdb.DatabaseTableMeta.dumpTableMeta(DatabaseTableMeta.java:233) ~[canal.parse-1.1.6.jar:na]

    at com.alibaba.otter.canal.parse.inbound.mysql.tsdb.DatabaseTableMeta.rollback(DatabaseTableMeta.java:174) ~[canal.parse-1.1.6.jar:na]

    at com.alibaba.otter.canal.parse.inbound.mysql.AbstractMysqlEventParser.processTableMeta(AbstractMysqlEventParser.java:142) ~[canal.parse-1.1.6.jar:na]

    at com.alibaba.otter.canal.parse.inbound.AbstractEventParser$1.run(AbstractEventParser.java:197) ~[canal.parse-1.1.6.jar:na]

    at java.lang.Thread.run(Thread.java:750) [na:1.8.0_331]

配置 canal.instance.filter.black.regex=.\.BASE. 解决

文档:https://github.com/alibaba/canal/issues/4219

8.2 adapter客户端

** 8.2.1: dir not exist (找不到目录)**

     1.解决方案:adapter目录不能存放在有中文路径的文件里

8.2.2: Did not matched any columns to update(没有任何一列可以更新)

     1.解决方案:数据库字段名特殊符号_ 下划线识别不了

8.2.3: 全量更新执行ETL命令报错 Task not fund 解决方案见(canal数据同步7.5(全量同步)

标签: mysql 数据库 java

本文转载自: https://blog.csdn.net/qq_43152576/article/details/125991133
版权归原作者 小杨哥哥的JAVA 所有, 如有侵权,请联系我们删除。

“Alibaba Canal数据同步 mysql->mysql”的评论:

还没有评论