实战 kafka connector 与 debezium mysql

语言: CN / TW / HK

本文已参与「新人创作礼」活动,一起开启掘金创作之路。

kafka connector

Kafka Connect 是一个可扩展、可靠的在Kafka和其他系统之间流传输的数据工具。它可以通过connectors(连接器)简单、快速的将大集合数据导入和导出kafka。

1. 安装配置

1.1 下载并配置kafka

我们使用的是kafka_2.13-2.8.0.tgz 您可以自行下载

解压到目录 D:\soft\kafka_2.13-2.8.0 这是我的根目录

修改 D:\soft\kafka_2.13-2.8.0\config 文件夹以下文件内容

zookeeper.properties 需要修改的地方:

textile dataDir=D:/soft/kafka_2.13-2.8.0/data/zookeeper

server.properties 需要修改的地方:

txt log.dirs=D:/soft/kafka_2.13-2.8.0/data/kafka-logs

在D:\soft\kafka_2.13-2.8.0\bin\windows 下我们新建一个 a.bat 文件内容如下

batch start zookeeper-server-start.bat ../../config/zookeeper.properties rem -E 如果sleep命令不可用可以用 ping -n 10 127.0.0.1>nul sleep 5 start kafka-server-start.bat ../../config/server.properties

这个命令会先启动 zookeeper 等zookeeper启动5秒后 再启动 kafka

1.2 下载图形管理界面 kafka-map

官方 kafka-map: 一个美观简洁且强大的kafka web管理工具。

下载地址 https://github.com/dushixiang/kafka-map/releases/latest/download/kafka-map.tgz

解压到 D:\soft\kafka_2.13-2.8.0\kafka-map

在 D:\soft\kafka_2.13-2.8.0\kafka-map 新建 startKafkaMap.bat 内容如下:

batch java -jar kafka-map.jar

1.3 启动验证

启动 a.bat

启动 startKafkaMap.bat

访问 http://localhost:8080/ ,账户和密码默认都是 admin

image.png 看到如下页面就是成功了

image.png

添加集群

image.png

image.png

2. kafka connector入门样例

我们先运行一下官方提供的一个例子,这个例子中会把server.properties 用FileStreamSource 读取然后保存到kafka 队列

然后用FileStreamSink 消费队列并保存到 server.properties1

2.1 配置connector

D:\soft\kafka_2.13-2.8.0\config\connect-distributed.properties

textile bootstrap.servers=localhost:9092

2.2 启动 connector

在 D:\soft\kafka_2.13-2.8.0\bin\windows 目录下先创建一个aConnect.bat 内容如下:

textile start zookeeper-server-start.bat ../../config/zookeeper.properties sleep 5 start kafka-server-start.bat ../../config/server.properties sleep 5 start connect-distributed.bat ../../config/connect-distributed.properties

2.3 检查环境

发送 GET 请求到 http://localhost:8083/ 查看状态

image.png

查看所有插件 http://localhost:8083/connector-plugins

image.png

2.3 配置 file connector source 端

FileStreamSource 会把 "D:/soft/kafka_2.13-2.8.0/config/server.properties" 这个文件逐行读取后保存到 "kafka-config-topic" 这个队列中

http://localhost:8083/connectors

json { "name":"load-kafka-config", "config":{ "connector.class":"FileStreamSource", "file":"D:/soft/kafka_2.13-2.8.0/config/server.properties", "topic":"kafka-config-topic" } }

接口返回结果截图如下

image.png

查看状态

http://localhost:8083/connectors/load-kafka-config/status

image.png

在kafka-map中 点击箭头所指内容

image.png

image.png

image.png

查看topic 内容

image.png

2.4 配置 file connector sink端

FileStreamSink 会消费 "kafka-config-topic" 这个队列并把 内容保存到 "D:/soft/kafka_2.13-2.8.0/config/server.properties1"

http://localhost:8083/connectors

json { "name":"dump-kafka-config", "config":{ "connector.class":"FileStreamSink", "file":"D:/soft/kafka_2.13-2.8.0/config/server.properties1", "topics":"kafka-config-topic" } }

接口返回结果如下;

image.png

运行完成后会发现 D:\soft\kafka_2.13-2.8.0\config 目录下 多了一个server.properties1 文件,而且文件内容和 server.properties 一样

image.png

2.5 查看当前活跃的 connector

http://localhost:8083/connectors

image.png

2.6 删除connector

DELETE http://localhost:8083/connectors/load-kafka-config

DELETE http://localhost:8083/connectors/dump-kafka-config

查看 活跃的connetor,发现结果已经为空

image.png

3. 集成 debezium mysql connector

在这个例子中 我们会用 debezium mysql connector 监控mysql binlog 并把变更内容保存到kafka 队列中

3.1 mysql 准备

为了简单专门用于复制的用户我们就不创建了,我们直接用root 用户

必须配置以下参数

config [mysqld] server-id = 8023 port=8023 log-bin=D:/soft/mysql/mysql8023/data1/8023/binlog/mysql-bin transaction-isolation= READ-COMMITTED binlog_format = ROW gtid_mode =ON enforce_gtid_consistency = ON default-time-zone = '+8:00'

还有一些可选的优化参数请参考官方文档

https://debezium.io/documentation/reference/2.0/connectors/mysql.html#setting-up-mysql

准备好后就可以启动mysql了,在此我们用的mysql版本为8.0.29

准备一个测试库和一个测试表

``sql CREATE DATABASEtest1` ;

CREATE TABLE demo ( id INT(10) NOT NULL, name VARCHAR(50) NULL DEFAULT NULL , PRIMARY KEY (id) USING BTREE );

-- 插入测试数据 INSERT INTO demo (id, name) VALUES (111, '222'); ```

3.2 debezium 准备

下载 debezium 集成kafka connect 插件

https://repo1.maven.org/maven2/io/debezium/debezium-connector-mysql/2.0.0.Alpha1/debezium-connector-mysql-2.0.0.Alpha1-plugin.tar.gz

把 文件debezium-connector-mysql-2.0.0.Alpha1-plugin.tar.gz 解压到 D:\soft\kafka_2.13-2.8.0\plugin

image.png

connect-distributed.properties 配置如下参数,注意路径不要包含 debezium-connector-mysql

config plugin.path=D:/soft/kafka_2.13-2.8.0/plugin/

添加完成后需要重启kafka 和 connect

查看启动日志是否已经加载插件

txt [2022-05-11 16:09:48,408] INFO Registered loader: PluginClassLoader{pluginLocation=file:/D:/soft/kafka_2.13-2.8.0/plugin/debezium-connector-mysql/} (org.apache.kafka.connect.runtime.isolation.DelegatingClassLoader:269) [2022-05-11 16:09:48,410] INFO Added plugin 'io.debezium.connector.mysql.MySqlConnector' (org.apache.kafka.connect.runtime.isolation.DelegatingClassLoader:198)

查看可用的插件

image.png

3.3 安装connnector

发送 POST 给 http://localhost:8083/connectors

请求正文为 connector 配置参数

json { "name": "conn-8023", "config": { "connector.class": "io.debezium.connector.mysql.MySqlConnector", "database.hostname": "localhost", "database.port": "8023", "database.user": "root", "database.password": "123456", "database.server.id": "8023", "database.server.name": "local8023", "database.include.list": "test1", "database.history.kafka.bootstrap.servers": "localhost:9092", "database.history.kafka.topic": "dbhistory.local8023", "include.schema.changes": "true" } }

参考图片

image.png

3.4 查看运行状态

image.png

用kafka-map 查看数据

image.png

查看 local8023.test1.demo 的数据

json { "schema": { ... }, "payload": { "before": null, "after": { "id": 111, "name": "222" }, "source": { ... }, "op": "r", "ts_ms": 1652258099933, "transaction": null } }

再执行一些sql测试一下

sql -- 插入测试数据 INSERT INTO `demo` (`id`, `name`) VALUES (222, '新数据222'); update demo set name='111修改后' where id=111; DELETE FROM demo WHERE id=222;

插入事件

json "payload": { "before": null, "after": { "id": 222, "name": "新数据222" }, "source": { ... }, "op": "c", "ts_ms": 1652258788884, "transaction": null }

修改事件

json "payload": { "before": { "id": 111, "name": "222" }, "after": { "id": 111, "name": "111修改后" }, "source": { ... }, "op": "u", "ts_ms": 1652258788887, "transaction": null }

删除事件

json "payload": { "before": { "id": 222, "name": "新数据222" }, "after": null, "source": { ... }, "op": "d", "ts_ms": 1652258985267, "transaction": null }

删除后的墓碑事件

image.png