1.canal介绍
canal的工作原理就是把自己伪装成MySQL slave，模拟MySQL slave的交互协议向MySQL Mater发送 dump协议，MySQL mater收到canal发送过来的dump请求，开始推送binary log给canal，然后canal解析binary log，再发送到存储目的地，比如MySQL，Kafka，Elastic Search等等。
1.MySQL的安装
2.为canal-server添加用户
安装好MySQL之后添加一个用户，用于canal-server使用。
-- 创建用户 用户名：canal 密码：Canal@123456
create user ‘canal‘@‘%‘ identified by ‘Canal@123456‘;
-- 授权 *.*表示所有库
grant SELECT, REPLICATION SLAVE, REPLICATION CLIENT on *.* to ‘canal‘@‘%‘ identified by ‘Canal@123456‘;
3.开启MySQL的binlog
下一步在MySQL配置文件my.cnf设置如下信息：
[[mysqld]
# 打开binlog
log-bin=mysql-bin
# 选择ROW(行)模式
binlog-format=ROW
# 配置MySQL replaction需要定义，不要和canal的slaveId重复
server_id=1
改了配置文件之后，重启MySQL，使用命令查看是否打开binlog模式：
4.创建两个数据库表,用于本次数据同步的测试
至此MySQL服务器准备完成.
3.docker安装canal-server
去docker hub上找到canal-server镜像，我这里使用canal/canal-server:latest
#拉取镜像
docker pull canal/canal-server:latest
#第一次运行
docker run --name canal-server -p 11111:11111 -d canal/canal-server:latest
这次运行的目的是为了找到配置文件instance.properties的目录，然后把配置文件挂载出来，方便之后在容器之外修改。
rroot@ubuntu:/opt/canal-adapter/conf# docker exec -it canal-server bash
[root@53b382d287 admin]# ls
app.sh ?bin ?canal-server ?health.sh ?node_exporter ?node_exporter-0.18.1.linux-arm64
[root@53b382d287 admin]# cd canal-server/
[root@53b382d287 canal-server]# ls
bin ?conf ?lib ?logs ?plugin
[root@53b382d287 canal-server]# cd conf/
[root@53b382d287 conf]# ls
canal_local.properties ?canal.properties ?example ?logback.xml ?metrics ?spring
[root@53b382d287 conf]# cd example/
[root@53b382d287 example]# ls
h2.mv.db ?instance.properties ?meta.dat
[root@53b382d287 example]# pwd
/home/admin/canal-server/conf/example
创建文件夹，我这里的路径是/opt/canal-server
#创建文件夹
mkdir /opt/canal-server
#进入目录
cd /opt/canal-server
#将instance.properties从容器中拷贝出来
docker cp canal-server:/home/admin/canal-server/conf/example/instance.properties ./
修改拷贝出来的instance.properties
停止正在运行的canal-server，并删除容器,重新运行canal-server
#停止容器
docker stop canal-server
#删除容器
docker rm canal-server
#重新运行canal-server,使用挂载出来的配置文件
docker run --name canal-server -p 11111:11111 -v /opt/canal-server:/home/admin/canal-server/conf/example -d canal/canal-server:latest
查看canal-server是否运行成功
至此docker安装canal-server完成
4.docker安装canal-adapter
同样去docker hub上找到canal-adapter镜像，我这里使用slpcat/canal-adapter:v1.1.5
#拉取镜像
docker pull slpcat/canal-adapter:v1.1.5
#第一次运行
docker run --name canal-adapter -p 8081:8081 -d slpcat/canal-adapter:v1.1.5
这次运行的目的是为了找到配置文件application.yml、mytest_user.yml的目录，然后把配置文件挂载出来，方便之后在容器之外修改。
root@ubuntu:/opt/canal-server# docker exec -it canal-adapter bash
root@07e46971cd:/opt/canal-adapter# ls
bin ?conf ?lib ? ?logs ?plugin
root@07e46971cd:/opt/canal-adapter# cd conf/
root@07e46971cd:/opt/canal-adapter/conf# ls
application.yml ?rdb
root@07e46971cd:/opt/canal-adapter/conf# pwd
/opt/canal-adapter/conf
root@07e46971cd:/opt/canal-adapter/conf# cd rdb/
root@07e46971cd:/opt/canal-adapter/conf/rdb# ls
mytest_user.yml
root@07e46971cd:/opt/canal-adapter/conf/rdb# pwd
/opt/canal-adapter/conf/rdb
root@07e46971cd:/opt/canal-adapter/conf/rdb#?
创建文件夹，我这里的路径是/opt/canal-adapter/conf、/opt/canal-adapter/conf/rdb
#创建conf文件夹
mkdir /opt/canal-adapter/conf
#创建rdb文件夹
mkdir /opt/canal-adapter/conf/rdb
#进入conf目录
cd /opt/canal-adapter/conf
#将 application.yml 从容器中拷贝到conf文件夹
docker cp canal-adapter:/opt/canal-adapter/conf/application.yml ./
#进入rdb文件夹
cd ?/opt/canal-adapter/conf/rdb
#将 mytest_user.yml 从容器中拷贝到rdb文件夹
docker cp canal-adapter:/opt/canal-adapter/conf/rdb/mytest_user.yml ./
修改拷贝出来的application.yml
修改拷贝出来的mytest_user.yml
停止正在运行的canal-adapter，并删除容器,重新运行canal-adapter
#停止容器
docker stop canal-adapter
#删除容器
docker rm canal-adapter
#重新运行canal-adapter,使用挂载出来的配置文件
docker run --name canal-adapter -p 8081:8081 -v /opt/canal-adapter/conf:/opt/canal-adapter/conf -v /opt/canal-adapter/conf/rdb:/opt/canal-adapter/conf/rdb -d slpcat/canal-adapter:v1.1.5
查看canal-adapter是否运行成功
至此docker安装canal-adapter完成
5.验证数据同步
在源数据库表mytest1.user中新增数据,在目标数据库表mytest2.user中刷新将看到数据已经自动同步。在canal-adapter的日志中也可以查看到数据同步信息
canal.properties配置：
#################################################
######### ? ? ? ? common argument ? ? ? ?#############
#################################################
# tcp bind ip
canal.ip =
# register ip to zookeeper
canal.register.ip =
canal.port = 11111
canal.metrics.pull.port = 11112
# canal instance user/passwd
# canal.user = canal
# canal.passwd = E3619321C1A937C46A0D8BD1DAC39F93B27D4458
# canal admin config
#canal.admin.manager = 127.0.0.1:8089
canal.admin.port = 11110
canal.admin.user = admin
canal.admin.passwd = 4ACFE3202A5FF5CF467898FC58AAB1D615029441
# admin auto register
#canal.admin.register.auto = true
#canal.admin.register.cluster =
#canal.admin.register.name =
canal.zkServers =
# flush data to zk
canal.zookeeper.flush.period = 1000
canal.withoutNetty = false
# tcp, kafka, rocketMQ, rabbitMQ
canal.serverMode = tcp
# flush meta cursor/parse position to file
canal.file.data.dir = ${canal.conf.dir}
canal.file.flush.period = 1000
## memory store RingBuffer size, should be Math.pow(2,n)
canal.instance.memory.buffer.size = 16384
## memory store RingBuffer used memory unit size , default 1kb
canal.instance.memory.buffer.memunit = 1024?
## meory store gets mode used MEMSIZE or ITEMSIZE
canal.instance.memory.batch.mode = MEMSIZE
canal.instance.memory.rawEntry = true
## detecing config
canal.instance.detecting.enable = false
#canal.instance.detecting.sql = insert into retl.xdual values(1,now()) on duplicate key update x=now()
canal.instance.detecting.sql = select 1
canal.instance.detecting.interval.time = 3
canal.instance.detecting.retry.threshold = 3
canal.instance.detecting.heartbeatHaEnable = false
# support maximum transaction size, more than the size of the transaction will be cut into multiple transactions delivery
canal.instance.transaction.size = ?1024
# mysql fallback connected to new master should fallback times
canal.instance.fallbackIntervalInSeconds = 60
# network config
canal.instance.network.receiveBufferSize = 16384
canal.instance.network.sendBufferSize = 16384
canal.instance.network.soTimeout = 30
# binlog filter config
canal.instance.filter.druid.ddl = true
canal.instance.filter.query.dcl = false
canal.instance.filter.query.dml = false
canal.instance.filter.query.ddl = false
canal.instance.filter.table.error = false
canal.instance.filter.rows = false
canal.instance.filter.transaction.entry = false
canal.instance.filter.dml.insert = false
canal.instance.filter.dml.update = false
canal.instance.filter.dml.delete = false
# binlog format/image check
canal.instance.binlog.format = ROW,STATEMENT,MIXED?
canal.instance.binlog.image = FULL,MINIMAL,NOBLOB
# binlog ddl isolation
canal.instance.get.ddl.isolation = false
# parallel parser config
canal.instance.parser.parallel = true
## concurrent thread number, default 60% available processors, suggest not to exceed Runtime.getRuntime().availableProcessors()
#canal.instance.parser.parallelThreadSize = 16
## disruptor ringbuffer size, must be power of 2
canal.instance.parser.parallelBufferSize = 256
# table meta tsdb info
canal.instance.tsdb.enable = true
canal.instance.tsdb.dir = ${canal.file.data.dir:../conf}/${canal.instance.destination:}
canal.instance.tsdb.url = jdbc:h2:${canal.instance.tsdb.dir}/h2;CACHE_SIZE=1000;MODE=MYSQL;
canal.instance.tsdb.dbUsername = canal
canal.instance.tsdb.dbPassword = canal
# dump snapshot interval, default 24 hour
canal.instance.tsdb.snapshot.interval = 24
# purge snapshot expire , default 360 hour(15 days)
canal.instance.tsdb.snapshot.expire = 360
#################################################
######### ? ? ? ? destinations ? ? ? ?#############
#################################################
canal.destinations = example
# conf root dir
canal.conf.dir = ../conf
# auto scan instance dir add/remove and start/stop instance
canal.auto.scan = true
canal.auto.scan.interval = 5
# set this value to ‘true‘ means that when binlog pos not found, skip to latest.
# WARN: pls keep ‘false‘ in production env, or if you know what you want.
canal.auto.reset.latest.pos.mode = false
canal.instance.tsdb.spring.xml = classpath:spring/tsdb/h2-tsdb.xml
#canal.instance.tsdb.spring.xml = classpath:spring/tsdb/mysql-tsdb.xml
canal.instance.global.mode = spring
canal.instance.global.lazy = false
canal.instance.global.manager.address = ${canal.admin.manager}
#canal.instance.global.spring.xml = classpath:spring/memory-instance.xml
canal.instance.global.spring.xml = classpath:spring/file-instance.xml
#canal.instance.global.spring.xml = classpath:spring/default-instance.xml
##################################################
######### ? ? ? ? ? MQ Properties ? ? ?#############
##################################################
# aliyun ak/sk , support rds/mq
canal.aliyun.accessKey =
canal.aliyun.secretKey =
canal.aliyun.uid=
canal.mq.flatMessage = true
canal.mq.canalBatchSize = 50
canal.mq.canalGetTimeout = 100
# Set this value to "cloud", if you want open message trace feature in aliyun.
canal.mq.accessChannel = local
canal.mq.database.hash = true
canal.mq.send.thread.size = 30
canal.mq.build.thread.size = 8
##################################################
######### ? ? ? ? ? ? ?Kafka ? ? ? ? ? ? ?#############
##################################################
kafka.bootstrap.servers = 127.0.0.1:9092
kafka.acks = all
kafka.compression.type = none
kafka.batch.size = 16384
kafka.linger.ms = 1
kafka.max.request.size = 1048576
kafka.buffer.memory = 33554432
kafka.max.in.flight.requests.per.connection = 1
kafka.retries = 0
kafka.kerberos.enable = false
kafka.kerberos.krb5.file = "../conf/kerberos/krb5.conf"
kafka.kerberos.jaas.file = "../conf/kerberos/jaas.conf"
##################################################
######### ? ? ? ? ? ? RocketMQ ? ? ? ? #############
##################################################
rocketmq.producer.group = test
rocketmq.enable.message.trace = false
rocketmq.customized.trace.topic =
rocketmq.namespace =
rocketmq.namesrv.addr = 127.0.0.1:9876
rocketmq.retry.times.when.send.failed = 0
rocketmq.vip.channel.enabled = false
rocketmq.tag =?
##################################################
######### ? ? ? ? ? ? RabbitMQ ? ? ? ? #############
##################################################
rabbitmq.host =
rabbitmq.virtual.host =
rabbitmq.exchange =
rabbitmq.username =
rabbitmq.password =
rabbitmq.deliveryMode =
instance.properties配置：
#################################################
## mysql serverId , v1.0.26+ will autoGen
# canal.instance.mysql.slaveId=0
# enable gtid use true/false
canal.instance.gtidon=false
# position info
canal.instance.master.address=10.86.70.88:3306
canal.instance.master.journal.name=
canal.instance.master.position=
canal.instance.master.timestamp=
canal.instance.master.gtid=
# rds oss binlog
canal.instance.rds.accesskey=
canal.instance.rds.secretkey=
canal.instance.rds.instanceId=
# table meta tsdb info
canal.instance.tsdb.enable=true
#canal.instance.tsdb.url=jdbc:mysql://127.0.0.1:3306/canal_tsdb
#canal.instance.tsdb.dbUsername=canal
#canal.instance.tsdb.dbPassword=canal
#canal.instance.standby.address =
#canal.instance.standby.journal.name =
#canal.instance.standby.position =
#canal.instance.standby.timestamp =
#canal.instance.standby.gtid=
# username/password
canal.instance.dbUsername=canal
canal.instance.dbPassword=canal
canal.instance.connectionCharset = UTF-8
# enable druid Decrypt database password
canal.instance.enableDruid=false
#canal.instance.pwdPublicKey=MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBALK4BUxdDltRRE5/zXpVEVPUgunvscYFtEip3pmLlhrWpacX7y7GCMo2/JM6LeHmiiNdH1FWgGCpUfircSwlWKUCAwEAAQ==
# table regex
canal.instance.filter.regex=.*\\..*
# table black regex
canal.instance.filter.black.regex=mysql\\.slave_.*
# table field filter(format: schema1.tableName1:field1/field2,schema2.tableName2:field1/field2)
#canal.instance.filter.field=test1.t_product:id/subject/keywords,test2.t_company:id/name/contact/ch
# table field black filter(format: schema1.tableName1:field1/field2,schema2.tableName2:field1/field2)
#canal.instance.filter.black.field=test1.t_product:subject/product_image,test2.t_company:id/name/contact/ch
# mq config
canal.mq.topic=example
# dynamic topic route by schema or table regex
#canal.mq.dynamicTopic=mytest1.user,mytest2\\..*,.*\\..*
canal.mq.partition=0
# hash partition config
#canal.mq.partitionsNum=3
#canal.mq.partitionHash=test.table:id^name,.*\\..*
#canal.mq.dynamicTopicPartitionNum=test.*:4,mycanal:6
#################################################
application.yml配置：
server:
? port: 8081
spring:
? jackson:
? ? date-format: yyyy-MM-dd HH:mm:ss
? ? time-zone: GMT+8
? ? default-property-inclusion: non_null
canal.conf:
? mode: tcp #tcp kafka rocketMQ rabbitMQ
? flatMessage: true
? zookeeperHosts:
? syncBatchSize: 1000
? retries: 0
? timeout:
? accessKey:
? secretKey:
? consumerProperties:
? ? # canal tcp consumer
? ? canal.tcp.server.host: 10.86.70.88:11111
? ? canal.tcp.zookeeper.hosts:
? ? canal.tcp.batch.size: 500
? ? canal.tcp.username:
? ? canal.tcp.password:
? ? # kafka consumer
? ? kafka.bootstrap.servers: 127.0.0.1:9092
? ? kafka.enable.auto.commit: false
? ? kafka.auto.commit.interval.ms: 1000
? ? kafka.auto.offset.reset: latest
? ? kafka.request.timeout.ms: 40000
? ? kafka.session.timeout.ms: 30000
? ? kafka.isolation.level: read_committed
? ? kafka.max.poll.records: 1000
? ? # rocketMQ consumer
? ? rocketmq.namespace:
? ? rocketmq.namesrv.addr: 127.0.0.1:9876
? ? rocketmq.batch.size: 1000
? ? rocketmq.enable.message.trace: false
? ? rocketmq.customized.trace.topic:
? ? rocketmq.access.channel:
? ? rocketmq.subscribe.filter:
? ? # rabbitMQ consumer
? ? rabbitmq.host:
? ? rabbitmq.virtual.host:
? ? rabbitmq.username:
? ? rabbitmq.password:
? ? rabbitmq.resource.ownerId:
? srcDataSources:
? ? defaultDS:
? ? ? url: jdbc:mysql://10.86.70.88:3306/mytest?useUnicode=true
? ? ? username: root
? ? ? password: as246367
? canalAdapters:
? - instance: example # canal instance Name or mq topic name
? ? groups:
? ? - groupId: g1
? ? ? outerAdapters:
? ? ? - name: logger
? ? ? - name: rdb
? ? ? ? key: mysql1
? ? ? ? properties:
? ? ? ? ? jdbc.driverClassName: com.mysql.jdbc.Driver
? ? ? ? ? jdbc.url: jdbc:mysql://10.86.70.88:3306/mytest2?useUnicode=true
? ? ? ? ? jdbc.username: root
? ? ? ? ? jdbc.password: as246367
# ? ? ?- name: rdb
# ? ? ? ?key: oracle1
# ? ? ? ?properties:
# ? ? ? ? ?jdbc.driverClassName: oracle.jdbc.OracleDriver
# ? ? ? ? ?jdbc.url: jdbc:oracle:thin:@localhost:49161:XE
# ? ? ? ? ?jdbc.username: mytest
# ? ? ? ? ?jdbc.password: m121212
# ? ? ?- name: rdb
# ? ? ? ?key: postgres1
# ? ? ? ?properties:
# ? ? ? ? ?jdbc.driverClassName: org.postgresql.Driver
# ? ? ? ? ?jdbc.url: jdbc:postgresql://localhost:5432/postgres
# ? ? ? ? ?jdbc.username: postgres
# ? ? ? ? ?jdbc.password: 121212
# ? ? ? ? ?threads: 1
# ? ? ? ? ?commitSize: 3000
# ? ? ?- name: hbase
# ? ? ? ?properties:
# ? ? ? ? ?hbase.zookeeper.quorum: 127.0.0.1
# ? ? ? ? ?hbase.zookeeper.property.clientPort: 2181
# ? ? ? ? ?zookeeper.znode.parent: /hbase
# ? ? ?- name: es
# ? ? ? ?hosts: 127.0.0.1:9300 # 127.0.0.1:9200 for rest mode
# ? ? ? ?properties:
# ? ? ? ? ?mode: transport # or rest
# ? ? ? ? ?# security.auth: test:123456 # ?only used for rest mode
# ? ? ? ? ?cluster.name: elasticsearch
# ? ? ? ?- name: kudu
# ? ? ? ? ?key: kudu
# ? ? ? ? ?properties:
# ? ? ? ? ? ?kudu.master.address: 127.0.0.1 # ‘,‘ split multi address
mytest_user.yml 配置：
dataSourceKey: defaultDS ? ? ? ?# 源数据源的key, 对应上面配置的srcDataSources中的值
destination: example ? ? ? ? ? ?# cannal的instance或者MQ的topic
groupId: g1 ? ? ? ? ? ? ? ? ? ? ?# 对应MQ模式下的groupId, 只会同步对应groupId的数据
outerAdapterKey: mysql1 ? ? ? ?# adapter key, 对应上面配置outAdapters中的key
concurrent: true ? ? ? ? ? ? ? ?# 是否按主键hash并行同步, 并行同步的表必须保证主键不会更改及主键不能为其他同步表的外键!!
dbMapping:
? database: mytest ? ? ? ? ? ? ?# 源数据源的database/shcema
? table: user ? ? ? ? ? ? ? ? ? # 源数据源表名
? targetTable: mytest2.user ? ? # 目标数据源的库名.表名
? targetPk: ? ? ? ? ? ? ? ? ? ? # 主键映射
? ? id: id ? ? ? ? ? ? ? ? ? ? ?# 如果是复合主键可以换行映射多个
? mapAll: true ? ? ? ? ? ? ? ? # 是否整表映射, 要求源表和目标表字段名一模一样 (如果targetColumns也配置了映射,则以targetColumns配置为准)
? etlCondition: "where c_time>={}"
? commitBatch: 3000
## Mirror schema synchronize config ?全库更新
#dataSourceKey: defaultDS
#destination: example
#groupId: g1
#outerAdapterKey: mysql1
#concurrent: true
#dbMapping:
# mirrorDb: true
#database: mytest
mytest_user2.yml 配置：
dataSourceKey: defaultDS ? ? ? ?# 源数据源的key, 对应上面配置的srcDataSources中的值
destination: example ? ? ? ? ? ?# cannal的instance或者MQ的topic
groupId: g1 ? ? ? ? ? ? ? ? ? ? ?# 对应MQ模式下的groupId, 只会同步对应groupId的数据
outerAdapterKey: mysql1 ? ? ? ?# adapter key, 对应上面配置outAdapters中的key
concurrent: true ? ? ? ? ? ? ? ?# 是否按主键hash并行同步, 并行同步的表必须保证主键不会更改及主键不能为其他同步表的外键!!
dbMapping:
? database: mytest ? ? ? ? ? ? ?# 源数据源的database/shcema
? table: user2 ? ? ? ? ? ? ? ? ? # 源数据源表名
? targetTable: mytest2.user2 ? ? # 目标数据源的库名.表名
? targetPk: ? ? ? ? ? ? ? ? ? ? # 主键映射
? ? id: id ? ? ? ? ? ? ? ? ? ? ?# 如果是复合主键可以换行映射多个
? mapAll: true ? ? ? ? ? ? ? ? # 是否整表映射, 要求源表和目标表字段名一模一样 (如果targetColumns也配置了映射,则以targetColumns配置为准)
? etlCondition: "where c_time>={}"
? commitBatch: 3000?
?
注意：?
1、如果msyql是8? 异常 因为8的加密方式不一样
2、需要同步的数据插入的时候，才会同步过去，除非全量同步之后
3、canal日志不能直接通过 docker logs canal查看，必须进入到容器中查看对应的log
//启动数据库
docker run -p 3306:3306 --name mysql2 -v /data/mysql2/datadir:/var/lib/mysql2 -e MYSQL_ROOT_PASSWORD=as246367 -d mysql:latest
//复制内容
docker cp canal:/home/admin/canal-server/conf/canal.properties /data/canal/
docker cp canal:/home/admin/canal-server/conf/example/instance.properties /data/canal/
//canal?
docker run --name canal -p 11111:11111 -d -v /data/canal/instance.properties:/home/admin/canal-server/conf/example/instance.properties -v /data/canal/canal.properties:/home/admin/canal-server/conf/canal.properties canal/canal-server:latest
//canal-adapter
docker run --name canal-adapter -p 8081:8081 -v /data/canal-adapter/conf:/opt/canal-adapter/conf -v /data/canal-adapter/conf/rdb:/opt/canal-adapter/conf/rdb -d slpcat/canal-adapter:v1.1.5
// canal-ui
sudo sh run_admin.sh -e server.port=8089 \
? ? ? ? -e canal.adminUser=admin \
? ? ? ? -e canal.adminPasswd=admin \
? ? ? ? -e spring.datasource.address=10.86.70.88:33061 \
? ? ? ? -e spring.datasource.database=canal_manager \
? ? ? ? -e spring.datasource.username=root \
? ? ? ? -e spring.datasource.password=as246367?
? ? ? ??
? ? ? ??
全量同步脚本：
curl http://127.0.0.1:8081/etl/rdb/mysql1/mytest_user.yml -X POST ? ?
?
?
参考：https://blog.csdn.net/hello123yy/article/details/117743993
?
?