拓展阅读

ETL-10-apache SeaTunnel Connector v2 source mysql cdc

mysql binlog

说明

mysql cdc source 生成的信息还算比较复杂，开始还以为需要自己写各种 jdbc sink 的语句。

结果发现，jdbc 提供了一个自动生成 sink sql 的语句，非常的方便。

本文主要来验证一下，多张表如何处理？

准备

mysql binlog windows10 环境的开启和解析笔记

database mysql install on windows10 WSL

这里我们定义一个拥有 binlog 权限的账户；

CREATE USER 'admin'@'%' IDENTIFIED BY '123456';
GRANT ALL PRIVILEGES ON *.* TO 'admin'@'%' WITH GRANT OPTION;
flush privileges;

确认开启了 binlog

mysql> show variables where variable_name in ('log_bin', 'binlog_format', 'binlog_row_image', 'gtid_mode', 'enforce_gtid_consistency');
+--------------------------+-------+
| Variable_name            | Value |
+--------------------------+-------+
| binlog_format            | ROW   |
| binlog_row_image         | FULL  |
| enforce_gtid_consistency | ON    |
| gtid_mode                | ON    |
| log_bin                  | ON    |
+--------------------------+-------+
5 rows in set, 1 warning (0.00 sec)

初始化表

我们模拟从源头库迁移到目标库。

源头库

create database migrate_source;
use migrate_source;

drop table if exists user_info;
create table user_info
(
    id int unsigned auto_increment comment '主键' primary key,
    username varchar(128) not null comment '用户名',
    create_time timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    update_time timestamp default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间'
) comment '用户表' ENGINE=Innodb default charset=utf8mb4 auto_increment=1;

drop table if exists role_info;
create table role_info
(
    id int unsigned auto_increment comment '主键' primary key,
    rolename varchar(128) not null comment '角色名',
    create_time timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    update_time timestamp default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间'
) comment '角色表' ENGINE=Innodb default charset=utf8mb4 auto_increment=1;

插入语句

use migrate_source;

truncate table user_info;
insert into user_info (username) values ('u1');
insert into user_info (username) values ('u2');
insert into user_info (username) values ('u3');
insert into user_info (username) values ('u4');

truncate table role_info;
insert into role_info (rolename) values ('r1');
insert into role_info (rolename) values ('r2');
insert into role_info (rolename) values ('r3');
insert into role_info (rolename) values ('r4');

确认：

mysql> select * from user_info;
+----+----------+---------------------+---------------------+
| id | username | create_time         | update_time         |
+----+----------+---------------------+---------------------+
|  1 | u1       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
|  2 | u2       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
|  3 | u3       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
|  4 | u4       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
+----+----------+---------------------+---------------------+
4 rows in set (0.00 sec)

mysql> select * from role_info;
+----+----------+---------------------+---------------------+
| id | rolename | create_time         | update_time         |
+----+----------+---------------------+---------------------+
|  1 | r1       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
|  2 | r2       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
|  3 | r3       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
|  4 | r4       | 2024-05-31 17:02:10 | 2024-05-31 17:02:10 |
+----+----------+---------------------+---------------------+
4 rows in set (0.00 sec)

目标

create database migrate_target;
use migrate_target;

drop table if exists user_info;
create table user_info
(
    id int unsigned auto_increment comment '主键' primary key,
    username varchar(128) not null comment '用户名',
    source varchar(16) comment '数据来源',
    create_time timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    update_time timestamp default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间'
) comment '用户表' ENGINE=Innodb default charset=utf8mb4 auto_increment=1;

drop table if exists role_info;
create table role_info
(
    id int unsigned auto_increment comment '主键' primary key,
    rolename varchar(128) not null comment '角色名',
    source varchar(16) comment '数据来源',
    create_time timestamp default CURRENT_TIMESTAMP not null comment '创建时间',
    update_time timestamp default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '更新时间'
) comment '角色表' ENGINE=Innodb default charset=utf8mb4 auto_increment=1;

要求

我们希望两张表都达到这个效果。

我们希望同步时，把原始的 id+9999，同时默认 source 指定一个值，比如 test。

如何实现呢？

思路

可以分别针对表，创建多个 cdc 服务，此处不再赘述。

这里还是希望可以合并出来，用同一个文件来验证。

1）source 选择 mysql-cdc

2) transfer 选择 sql

3) sink 选择 jdbc

实际测试

依赖包

<!--        添加测试 connector-->
<dependency>
    <groupId>org.apache.seatunnel</groupId>
    <artifactId>connector-jdbc</artifactId>
    <version>${project.version}</version>
</dependency>
<dependency>
    <groupId>org.apache.seatunnel</groupId>
    <artifactId>connector-cdc-mysql</artifactId>
    <version>${project.version}</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.27</version>
</dependency>

<!--   seatunnel-transforms-v2   -->
<dependency>
    <groupId>org.apache.seatunnel</groupId>
    <artifactId>seatunnel-transforms-v2</artifactId>
    <version>${project.version}</version>
</dependency>

配置例子

local_msyql_cdc_to_mysql_multi-tables.conf

其实配置就是隔离开，多对多即可。

测试了很多次，还是发现把直接拆分开比较简单。

# Defining the runtime environment
env {
  parallelism = 1
  job.mode = "STREAMING"
  checkpoint.interval = 10000
}

source {
    MySQL-CDC {
        category = {
            factory = MySQL
        }
        base-url = "jdbc:mysql://localhost:3306/migrate_source?useSSL=false&serverTimezone=Asia/Shanghai"
        driver = "com.mysql.cj.jdbc.Driver"
        username = "admin"
        password = "123456"
        table-names = ["migrate_source.role_info"]
        startup.mode = "initial"
        # 添加 result_table_name
        result_table_name = "cdc_role_info"
    }
    MySQL-CDC {
            category = {
                factory = MySQL
            }
            base-url = "jdbc:mysql://localhost:3306/migrate_source?useSSL=false&serverTimezone=Asia/Shanghai"
            driver = "com.mysql.cj.jdbc.Driver"
            username = "admin"
            password = "123456"
            table-names = ["migrate_source.user_info"]
            startup.mode = "initial"
            # 添加 result_table_name
            result_table_name = "cdc_user_info"
        }
}

transform {
    Sql {
        source_table_name = ["cdc_user_info"]  # 配置为列表格式
        result_table_name = "transformed_user_info"
        query = "SELECT id+9999 AS id, username, 'test' AS source, create_time, update_time FROM cdc_user_info"
    }
    Sql {
        source_table_name = ["cdc_role_info"]  # 配置为列表格式
        result_table_name = "transformed_role_info"
        query = "SELECT id+9999 AS id, rolename, 'test' AS source, create_time, update_time FROM cdc_role_info"
    }
}

sink {
    jdbc {
        source_table_name = ["transformed_user_info"]  # 配置为列表格式
        url = "jdbc:mysql://localhost:3306/migrate_target?useSSL=false&serverTimezone=Asia/Shanghai"
        driver = "com.mysql.cj.jdbc.Driver"
        user = "admin"
        password = "123456"
        database = "migrate_target"
        tablename = "user_info"
        generate_sink_sql = true
    }
    jdbc {
        source_table_name = ["transformed_role_info"]  # 配置为列表格式
        url = "jdbc:mysql://localhost:3306/migrate_target?useSSL=false&serverTimezone=Asia/Shanghai"
        driver = "com.mysql.cj.jdbc.Driver"
        user = "admin"
        password = "123456"
        database = "migrate_target"
        tablename = "role_info"
        generate_sink_sql = true
    }
}

初始化效果

use migrate_target;

mysql> select * from user_info;
+-------+----------+--------+---------------------+---------------------+
| id    | username | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | u1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | u2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | u3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | u4       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
+-------+----------+--------+---------------------+---------------------+
4 rows in set (0.00 sec)

mysql> select * from role_info;
+-------+----------+--------+---------------------+---------------------+
| id    | rolename | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | r1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | r2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | r3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | r4       | test   | 2024-05-31 17:46:33 | 2024-05-31 17:46:33 |
+-------+----------+--------+---------------------+---------------------+
4 rows in set (0.01 sec)

增量效果

我们分别测试一下增加/修改/删除

增加

source:

use migrate_source;
insert into user_info(username) values ('u5');
insert into role_info(rolename) values ('r5');

target:

mysql> use migrate_target;
Database changed
mysql> select * from user_info;
+-------+----------+--------+---------------------+---------------------+
| id    | username | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | u1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | u2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | u3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | u4       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10004 | u5       | test   | 2024-05-31 17:56:46 | 2024-05-31 17:56:46 |
+-------+----------+--------+---------------------+---------------------+
5 rows in set (0.00 sec)

mysql> select * from user_info;
+-------+----------+--------+---------------------+---------------------+
| id    | username | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | u1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | u2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | u3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | u4       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10004 | u5       | test   | 2024-05-31 17:56:46 | 2024-05-31 17:56:46 |
+-------+----------+--------+---------------------+---------------------+
5 rows in set (0.00 sec)

修改

source:

use migrate_source;
update user_info  set username='u5-edit' where id=5;
update role_info  set rolename='r5-edit' where id=5;

target:

mysql> use migrate_target;
Database changed
mysql> select * from user_info;
+-------+----------+--------+---------------------+---------------------+
| id    | username | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | u1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | u2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | u3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | u4       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10004 | u5-edit  | test   | 2024-05-31 17:56:46 | 2024-05-31 17:57:53 |
+-------+----------+--------+---------------------+---------------------+
5 rows in set (0.00 sec)

mysql> select * from role_info;
+-------+----------+--------+---------------------+---------------------+
| id    | rolename | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | r1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | r2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | r3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | r4       | test   | 2024-05-31 17:46:33 | 2024-05-31 17:46:33 |
| 10004 | r5-edit  | test   | 2024-05-31 17:56:47 | 2024-05-31 17:57:54 |
+-------+----------+--------+---------------------+---------------------+
5 rows in set (0.00 sec)

删除

source:

use migrate_source;
delete from user_info where id=5;
delete from role_info where id=5;

target:

mysql> use migrate_target;
Database changed
mysql> select * from user_info;
+-------+----------+--------+---------------------+---------------------+
| id    | username | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | u1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | u2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | u3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | u4       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
+-------+----------+--------+---------------------+---------------------+
4 rows in set (0.00 sec)

mysql> select * from role_info;
+-------+----------+--------+---------------------+---------------------+
| id    | rolename | source | create_time         | update_time         |
+-------+----------+--------+---------------------+---------------------+
| 10000 | r1       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10001 | r2       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10002 | r3       | test   | 2024-05-31 17:46:32 | 2024-05-31 17:46:32 |
| 10003 | r4       | test   | 2024-05-31 17:46:33 | 2024-05-31 17:46:33 |
+-------+----------+--------+---------------------+---------------------+
4 rows in set (0.00 sec)

小结

整体而言，直接一个文件中写多个就可以实现这个 cdc 同步，seatunnel 设计的确实比较灵活。

也可以拆分为多个单个文件也可以，但是那样消耗的资源会多一些，可以自己选择。

不要闭门造车。

拓展阅读
说明
- 准备
- 初始化表
  - 源头库
  - 目标
  - 要求
  - 思路
实际测试
- 依赖包
- 配置例子
- 初始化效果
- 增量效果
  - 增加
  - 修改
  - 删除
小结

ETL-25-apache SeaTunnel 实战 source mysql CDC 到 sink jdbc id 增加 transfer+多张表

拓展阅读

说明

准备

初始化表

源头库

目标

要求

思路

实际测试

依赖包

配置例子

初始化效果

增量效果

增加

修改

删除

小结

更多学习