开始开始

下载地址 https://github.com/alibaba/canal/releases

二进制安装

下载

  1. wget https://github.com/alibaba/canal/releases/download/canal-1.1.5/canal.deployer-1.1.5.tar.gz
  2. mkdir canal

docker 安装

官方文档https://github.com/alibaba/canal/wiki/Docker-QuickStart
dockerfile文件

docker hub 地址：https://hub.docker.com/r/canal/canal-server

配置参数

官方文档说明 https://github.com/alibaba/canal/wiki/AdminGuide

Mysql 配置

  1. [mysqld]
  2. log-bin=mysql-bin # 开启 binlog
  3. binlog-format=ROW # 选择 ROW 模式
  4. server_id=1 # 配置 MySQL replaction 需要定义，不要和 canal 的 slaveId 重复

创建用户

  1. CREATE USER canal IDENTIFIED BY 'canal';  
  2. GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'canal'@'%';
  3. -- GRANT ALL PRIVILEGES ON *.* TO 'canal'@'%' ;
  4. FLUSH PRIVILEGES;

canal配置

canal.properties

  1. #################################################
  2. #########         common argument        #############
  3. #################################################
  4. # tcp bind ip
  5. canal.ip =
  6. # register ip to zookeeper
  7. canal.register.ip =
  8. canal.port = 11111
  9. canal.metrics.pull.port = 11112
  10. # canal instance user/passwd
  11. # canal.user = canal
  12. # canal.passwd = E3619321C1A937C46A0D8BD1DAC39F93B27D4458
  14. # canal admin config
  15. #canal.admin.manager = 127.0.0.1:8089
  16. canal.admin.port = 11110
  17. canal.admin.user = admin
  18. canal.admin.passwd = 4ACFE3202A5FF5CF467898FC58AAB1D615029441
  19. # admin auto register
  20. #canal.admin.register.auto = true
  21. #canal.admin.register.cluster =
  22. #canal.admin.register.name =
  24. canal.zkServers =
  25. # flush data to zk
  26. canal.zookeeper.flush.period = 1000
  27. canal.withoutNetty = false
  28. # tcp, kafka, rocketMQ, rabbitMQ
  29. canal.serverMode = tcp
  30. # flush meta cursor/parse position to file
  31. canal.file.data.dir = ${canal.conf.dir}
  32. canal.file.flush.period = 1000
  33. ## memory store RingBuffer size, should be Math.pow(2,n)
  34. canal.instance.memory.buffer.size = 16384
  35. ## memory store RingBuffer used memory unit size , default 1kb
  36. canal.instance.memory.buffer.memunit = 1024 
  37. ## meory store gets mode used MEMSIZE or ITEMSIZE
  38. canal.instance.memory.batch.mode = MEMSIZE
  39. canal.instance.memory.rawEntry = true
  41. ## detecing config
  42. canal.instance.detecting.enable = false
  43. #canal.instance.detecting.sql = insert into retl.xdual values(1,now()) on duplicate key update x=now()
  44. canal.instance.detecting.sql = select 1
  45. canal.instance.detecting.interval.time = 3
  46. canal.instance.detecting.retry.threshold = 3
  47. canal.instance.detecting.heartbeatHaEnable = false
  49. # support maximum transaction size, more than the size of the transaction will be cut into multiple transactions delivery
  50. canal.instance.transaction.size =  1024
  51. # mysql fallback connected to new master should fallback times
  52. canal.instance.fallbackIntervalInSeconds = 60
  54. # network config
  55. canal.instance.network.receiveBufferSize = 16384
  56. canal.instance.network.sendBufferSize = 16384
  57. canal.instance.network.soTimeout = 30
  59. # binlog filter config
  60. canal.instance.filter.druid.ddl = true
  61. canal.instance.filter.query.dcl = false
  62. canal.instance.filter.query.dml = false
  63. canal.instance.filter.query.ddl = false
  64. canal.instance.filter.table.error = false
  65. canal.instance.filter.rows = false
  66. canal.instance.filter.transaction.entry = false
  67. canal.instance.filter.dml.insert = false
  68. canal.instance.filter.dml.update = false
  69. canal.instance.filter.dml.delete = false
  71. # binlog format/image check
  72. canal.instance.binlog.format = ROW,STATEMENT,MIXED 
  73. canal.instance.binlog.image = FULL,MINIMAL,NOBLOB
  75. # binlog ddl isolation
  76. canal.instance.get.ddl.isolation = false
  78. # parallel parser config
  79. canal.instance.parser.parallel = true
  80. ## concurrent thread number, default 60% available processors, suggest not to exceed Runtime.getRuntime().availableProcessors()
  81. #canal.instance.parser.parallelThreadSize = 16
  82. ## disruptor ringbuffer size, must be power of 2
  83. canal.instance.parser.parallelBufferSize = 256
  85. # table meta tsdb info
  86. canal.instance.tsdb.enable = true
  87. canal.instance.tsdb.dir = ${canal.file.data.dir:../conf}/${canal.instance.destination:}
  88. canal.instance.tsdb.url = jdbc:h2:${canal.instance.tsdb.dir}/h2;CACHE_SIZE=1000;MODE=MYSQL;
  89. canal.instance.tsdb.dbUsername = canal
  90. canal.instance.tsdb.dbPassword = canal
  91. # dump snapshot interval, default 24 hour
  92. canal.instance.tsdb.snapshot.interval = 24
  93. # purge snapshot expire , default 360 hour(15 days)
  94. canal.instance.tsdb.snapshot.expire = 360
  96. #################################################
  97. #########         destinations        #############
  98. #################################################
  99. canal.destinations = example
  100. # conf root dir
  101. canal.conf.dir = ../conf
  102. # auto scan instance dir add/remove and start/stop instance
  103. canal.auto.scan = true
  104. canal.auto.scan.interval = 5
  105. # set this value to 'true' means that when binlog pos not found, skip to latest.
  106. # WARN: pls keep 'false' in production env, or if you know what you want.
  107. canal.auto.reset.latest.pos.mode = false
  109. canal.instance.tsdb.spring.xml = classpath:spring/tsdb/h2-tsdb.xml
  110. #canal.instance.tsdb.spring.xml = classpath:spring/tsdb/mysql-tsdb.xml
  112. canal.instance.global.mode = spring
  113. canal.instance.global.lazy = false
  114. canal.instance.global.manager.address = ${canal.admin.manager}
  115. #canal.instance.global.spring.xml = classpath:spring/memory-instance.xml
  116. canal.instance.global.spring.xml = classpath:spring/file-instance.xml
  117. #canal.instance.global.spring.xml = classpath:spring/default-instance.xml
  119. ##################################################
  120. #########           MQ Properties      #############
  121. ##################################################
  122. # aliyun ak/sk , support rds/mq
  123. canal.aliyun.accessKey =
  124. canal.aliyun.secretKey =
  125. canal.aliyun.uid=
  127. canal.mq.flatMessage = true
  128. canal.mq.canalBatchSize = 50
  129. canal.mq.canalGetTimeout = 100
  130. # Set this value to "cloud", if you want open message trace feature in aliyun.
  131. canal.mq.accessChannel = local
  133. canal.mq.database.hash = true
  134. canal.mq.send.thread.size = 30
  135. canal.mq.build.thread.size = 8
  137. ##################################################
  138. #########              Kafka              #############
  139. ##################################################
  140. kafka.bootstrap.servers = 127.0.0.1:9092
  141. kafka.acks = all
  142. kafka.compression.type = none
  143. kafka.batch.size = 16384
  144. kafka.linger.ms = 1
  145. kafka.max.request.size = 1048576
  146. kafka.buffer.memory = 33554432
  147. kafka.max.in.flight.requests.per.connection = 1
  148. kafka.retries = 0
  150. kafka.kerberos.enable = false
  151. kafka.kerberos.krb5.file = "../conf/kerberos/krb5.conf"
  152. kafka.kerberos.jaas.file = "../conf/kerberos/jaas.conf"
  154. ##################################################
  155. #########             RocketMQ         #############
  156. ##################################################
  157. rocketmq.producer.group = test
  158. rocketmq.enable.message.trace = false
  159. rocketmq.customized.trace.topic =
  160. rocketmq.namespace =
  161. rocketmq.namesrv.addr = 127.0.0.1:9876
  162. rocketmq.retry.times.when.send.failed = 0
  163. rocketmq.vip.channel.enabled = false
  164. rocketmq.tag = 
  166. ##################################################
  167. #########             RabbitMQ         #############
  168. ##################################################
  169. rabbitmq.host =
  170. rabbitmq.virtual.host =
  171. rabbitmq.exchange =
  172. rabbitmq.username =
  173. rabbitmq.password =
  174. rabbitmq.deliveryMode =

实例配置

  1. #################################################
  2. ## mysql serverId , v1.0.26+ will autoGen
  3. # canal.instance.mysql.slaveId=0
  5. # enable gtid use true/false
  6. canal.instance.gtidon=false
  8. # position info
  9. canal.instance.master.address=127.0.0.1:3306
  10. canal.instance.master.journal.name=
  11. canal.instance.master.position=
  12. canal.instance.master.timestamp=
  13. canal.instance.master.gtid=
  15. # rds oss binlog
  16. canal.instance.rds.accesskey=
  17. canal.instance.rds.secretkey=
  18. canal.instance.rds.instanceId=
  20. # table meta tsdb info
  21. canal.instance.tsdb.enable=true
  22. #canal.instance.tsdb.url=jdbc:mysql://127.0.0.1:3306/canal_tsdb
  23. #canal.instance.tsdb.dbUsername=canal
  24. #canal.instance.tsdb.dbPassword=canal
  26. #canal.instance.standby.address =
  27. #canal.instance.standby.journal.name =
  28. #canal.instance.standby.position =
  29. #canal.instance.standby.timestamp =
  30. #canal.instance.standby.gtid=
  32. # username/password
  33. canal.instance.dbUsername=canal
  34. canal.instance.dbPassword=canal
  35. canal.instance.connectionCharset = UTF-8
  36. # enable druid Decrypt database password
  37. canal.instance.enableDruid=false
  38. #canal.instance.pwdPublicKey=MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBALK4BUxdDltRRE5/zXpVEVPUgunvscYFtEip3pmLlhrWpacX7y7GCMo2/JM6LeHmiiNdH1FWgGCpUfircSwlWKUCAwEAAQ==
  40. # table regex
  41. canal.instance.filter.regex=.*\\..*
  42. # table black regex
  43. canal.instance.filter.black.regex=mysql\\.slave_.*
  44. # table field filter(format: schema1.tableName1:field1/field2,schema2.tableName2:field1/field2)
  45. #canal.instance.filter.field=test1.t_product:id/subject/keywords,test2.t_company:id/name/contact/ch
  46. # table field black filter(format: schema1.tableName1:field1/field2,schema2.tableName2:field1/field2)
  47. #canal.instance.filter.black.field=test1.t_product:subject/product_image,test2.t_company:id/name/contact/ch
  49. # mq config
  50. canal.mq.topic=example
  51. # dynamic topic route by schema or table regex
  52. #canal.mq.dynamicTopic=mytest1.user,mytest2\\..*,.*\\..*
  53. canal.mq.partition=0
  54. # hash partition config
  55. #canal.mq.partitionsNum=3
  56. #canal.mq.partitionHash=test.table:id^name,.*\\..*
  57. #canal.mq.dynamicTopicPartitionNum=test.*:4,mycanal:6
  58. #################################################

MQ

image.png

参考

https://github.com/alibaba/canal/wiki/QuickStart
https://github.com/alibaba/canal/pull/3300

https://www.cnblogs.com/stayed/p/13542048.html