本教程将展示怎样利用 Flink CDC 快速构建从 MySQL 到 StarRocks 的 Streaming ELT 作业,包括同步一个数据库的所有表、模式变更演变和将分片表同步到一张表的功能。
本教程中的所有练习都在 Flink CDC CLI 中实行,整个过程利用标准 SQL 语法,无需一行 Java/Scala 代码或 IDE 安装。
预备
预备一台安装了 Docker 的 Linux 或 MacOS 电脑。
预备 Flink Standalone 集群
下载 Flink 1.18.0 ,解压得到 flink-1.18.0 目录。
利用以下下令进入 Flink 目录,并将 FLINK_HOME 设置为 flink-1.18.0 所在的目录。
通过将以下参数附加到 conf/flink-conf.yaml 配置文件来启用检查点,每 3 秒实行一次检查点。
- execution.checkpointing.interval: 3000
复制代码 利用以下下令启动 Flink 集群。
如果启动乐成,你就可以通过http://localhost:8081/访问Flink Web UI,如下所示。
多次实行start-cluster.sh可以启动多个TaskManager。
预备 docker compose
以下教程将利用 docker-compose 预备所需的组件。利用下面提供的内容创建 docker-compose.yml 文件:
- version: '2.1'
- services:
- StarRocks:
- image: starrocks/allin1-ubuntu:3.2.6
- ports:
- - "8080:8080"
- - "9030:9030"
- MySQL:
- image: debezium/example-mysql:1.1
- ports:
- - "3306:3306"
- environment:
- - MYSQL_ROOT_PASSWORD=123456
- - MYSQL_USER=mysqluser
- - MYSQL_PASSWORD=mysqlpw
复制代码 Docker Compose 应包含以下服务(容器):
- MySQL:包含一个名为 app_db 的数据库
- StarRocks:存储来自 MySQL 的表
该下令会主动以分离模式启动 Docker Compose 配置中界说的所有容器。运行 docker ps 检查这些容器是否正常运行。您也可以访问 http://localhost:8030/ 检查 StarRocks 是否正在运行。
为 MySQL 预备记录
进入 MySQL 容器
- docker-compose exec mysql mysql -uroot -p123456
复制代码 创建 app_db 数据库和订单、产物、发货表,然后插入记录
- -- create database
- CREATE DATABASE app_db;
- USE app_db;
- -- create orders table
- CREATE TABLE `orders` (
- `id` INT NOT NULL,
- `price` DECIMAL(10,2) NOT NULL,
- PRIMARY KEY (`id`)
- );
- -- insert records
- INSERT INTO `orders` (`id`, `price`) VALUES (1, 4.00);
- INSERT INTO `orders` (`id`, `price`) VALUES (2, 100.00);
- -- create shipments table
- CREATE TABLE `shipments` (
- `id` INT NOT NULL,
- `city` VARCHAR(255) NOT NULL,
- PRIMARY KEY (`id`)
- );
- -- insert records
- INSERT INTO `shipments` (`id`, `city`) VALUES (1, 'beijing');
- INSERT INTO `shipments` (`id`, `city`) VALUES (2, 'xian');
- -- create products table
- CREATE TABLE `products` (
- `id` INT NOT NULL,
- `product` VARCHAR(255) NOT NULL,
- PRIMARY KEY (`id`)
- );
- -- insert records
- INSERT INTO `products` (`id`, `product`) VALUES (1, 'Beer');
- INSERT INTO `products` (`id`, `product`) VALUES (2, 'Cap');
- INSERT INTO `products` (`id`, `product`) VALUES (3, 'Peanut');
复制代码 利用 Flink CDC CLI 提交作业
- 下载下面列出的二进制压缩包并解压到目录 flink cdc-3.1.0’:
flink-cdc-3.1.0-bin.tar.gz flink-cdc-3.1.0 目录下会包含四个目录:bin、lib、log、conf。
- 下载下面列出的连接器包并移动到 lib 目录
下载链接只针对稳固版本,SNAPSHOT 依赖必要自行基于 master 或 release 分支构建。请注意,必要将 jar 移动到 Flink CDC Home 的 lib 目录,而不是 Flink Home 的 lib 目录。
- MySQL 管道连接器 3.1.0
- StarRocks 管道连接器 3.1.0
您还必要将 MySQL 连接器放入 Flink lib 文件夹或利用 --jar 参数传递它,因为它们不再与 CDC 连接器一起打包:
编写任务配置yaml文件。下面是同步整个数据库的示例文件mysql-to-starrocks.yaml:
- ################################################################################
- # Description: Sync MySQL all tables to StarRocks
- ################################################################################
- source:
- type: mysql
- hostname: localhost
- port: 3306
- username: root
- password: 123456
- tables: app_db.\.*
- server-id: 5400-5404
- server-time-zone: UTC
- sink:
- type: starrocks
- name: StarRocks Sink
- jdbc-url: jdbc:mysql://127.0.0.1:9030
- load-url: 127.0.0.1:8080
- username: root
- password: ""
- table.create.properties.replication_num: 1
- pipeline:
- name: Sync MySQL Database to StarRocks
- parallelism: 2
复制代码 注意:
- source 中的 tables: app_db..* 通过正则匹配同步 app_db 中的所有表。
- sink 中的 table.create.properties.replication_num 是因为 Docker 镜像中只有一个 StarRocks BE 节点。
最后,利用Cli将作业提交到Flink Standalone集群。
- bash bin/flink-cdc.sh mysql-to-starrocks.yaml
复制代码 提交乐成后返回信息如下:
- Pipeline has been submitted to cluster.
- Job ID: 02a31c92f0e7bc9a1f4c0051980088a0
- Job Description: Sync MySQL Database to StarRocks
复制代码 我们可以通过 Flink Web UI 找到一个名为“Sync MySQL Database to StarRocks“的作业正在运行。
通过Dbeaver等数据库连接工具利用mysql://127.0.0.1:9030连接jdbc,可以在StarRocks中检察写入三张表的数据。
同步架构和数据更改
进入MySQL容器
- docker-compose exec mysql mysql -uroot -p123456
复制代码 然后修改MySQL中的schema和记录,Doris的表也会实时改变:
在MySQL中的orders中插入一条记录:
- INSERT INTO app_db.orders (id, price) VALUES (3, 100.00);
复制代码 在 MySQL 的订单中添加一列:
- ALTER TABLE app_db.orders ADD amount varchar(100) NULL;
复制代码 从 MySQL 更新订单中的一条记录:
- UPDATE app_db.orders SET price=100.00, amount=100.00 WHERE id=1;
复制代码 从 MySQL 中删除订单中的一条记录:
- DELETE FROM app_db.orders WHERE id=2;
复制代码 每实行一步革新一下Dbeaver,可以看到StarRocks中展示的订单表会实时更新,如下图:
同样的,通过修改shipping和products表,你也可以在StarRocks中实时看到同步修改的结果。
路由变更
Flink CDC 提供了将源表的表布局/数据路由到其他表名的配置。
利用此功能,我们可以实现表名、数据库名替换、全库同步等功能。以下是利用路由功能的示例文件:
- ################################################################################
- # Description: Sync MySQL all tables to StarRocks
- ################################################################################
- source:
- type: mysql
- hostname: localhost
- port: 3306
- username: root
- password: 123456
- tables: app_db.\.*
- server-id: 5400-5404
- server-time-zone: UTC
- sink:
- type: starrocks
- jdbc-url: jdbc:mysql://127.0.0.1:9030
- load-url: 127.0.0.1:8030
- username: root
- password: ""
- table.create.properties.replication_num: 1
- route:
- - source-table: app_db.orders
- sink-table: ods_db.ods_orders
- - source-table: app_db.shipments
- sink-table: ods_db.ods_shipments
- - source-table: app_db.products
- sink-table: ods_db.ods_products
- pipeline:
- name: Sync MySQL Database to StarRocks
- parallelism: 2
复制代码 通过上面的路由配置,我们可以将app_db.orders的表布局和数据同步到ods_db.ods_orders中,从而实现数据库迁徙的功能。具体来说,source-table支持正则匹配多表来同步分库分表,如下:
- route:
- - source-table: app_db.order\.*
- sink-table: ods_db.ods_orders
复制代码 这样我们就可以将app_db.order01、app_db.order02、app_db.order03中分片表同步到一张ods_db.ods_orders表中了。
注意,目前还不支持多张表存在雷同主键数据的场景,后续版本会支持。
清理
完成教程后,运行以下下令制止docker-compose.yml目录中的所有容器:
在Flink flink-1.18.0目录下,实行以下下令制止Flink集群:
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |