5分钟教你使用idea调试SeaTunnel自定义插件

在用Apache SeaTunnel研发SM2加密组件过程中，发现社区关于本地调试SeaTunnel文章过于简单，很多情况没有说明，于是根据自己遇到问题总结这篇文档。SeaTunnel本地调试官方文档，希望对大家有所帮助！

使用的引擎为Flink(不需要下载，SeaTunnel中有加载依赖),输入输出方式为：mysql to mysql

一、工具说明

1.idea2023.3.2

2.MySQL8.0.36

3.jdk1.8

4.seatunnel 2.3.4-release

二、开发前准备

1.从github拉下来代码

github地址：https://github.com/apache/seatunnel/

2.在控制台运行编译

编译指令为：

./mvnw clean install

Apache SeaTunnel2.3.3版本的编译可以参考大飞哥的博客4.2.1

3.创建数据库创建表

(注意，数据库不要使用mysql系统库(如：information_schema，mysql，performance_schema，sys)，需要自己创建新的数据库，seatunnel会排除这些系统库，2.3.4新增，2.3.3没有这个判断)。

4.添加配置文件

在seatunnel-flink-connector-v2-example项目的resource/examples下添加需要运行的配置文件，并修改SeaTunnelApiExample.java指向的文件路径

test.json(seatunnel支持运行json和config格式的配置文件)

{

"env" : {

"job.name" : "test"

},

"source" : [ {

"query" : "select t.id,t.name,t.depId,t.salary from seatunnel.t_employee t",

"fetch_size" : 0,

"url" : "jdbc:mysql://localhost:3306/seatunnel",

"driver" : "com.mysql.cj.jdbc.Driver",

"user" : "root",

"password" : "123456",

"plugin_name" : "Jdbc",

"result_table_name" : "_seatunnel_table_jdbc_8"

} ],

"transform" : [ {

"original_text" : "name",

"plugin_name" : "Sm2Encrypt",

"result_table_name" : "_seatunnel_table_sm2_9",

"source_table_name" : "_seatunnel_table_jdbc_8"

} ],

"sink" : [ {

"database" : "seatunnel",

"table" : "t_employee",

"support_upsert_by_query_primary_key_exist" : true,

"generate_sink_sql" : true,

"primary_keys" : [ "name" ],

"max_retries" : 3,

"batch_size" : 300,

"is_exactly_once" : false,

"url" : "jdbc:mysql://localhost:3306/seatunnel",

"driver" : "com.mysql.cj.jdbc.Driver",

"user" : "root",

"password" : "123456",

"plugin_name" : "Jdbc",

"source_table_name" : "_seatunnel_table_sm2_9"

} ]

}

Sm2Encrypt是我自己研发的国密加密组件，自定义插件的代码可以参考SeaTunnel扩展Transform插件，自定义转换插件

5.添加maven

seatunnel-flink-connector-v2-example项目添加下列pom依赖并刷新maven，没有这些依赖会报错，连接方式用到什么就要添加什么，我这里使用的是connector-jdbc。如果source或sink用到http连接就需要添加connect-http依赖,具体有哪些可以看seatunnel-connectors-v2项目下的包

org.apache.seatunnel
connector-jdbc
${project.version}

因为使用的是mysql数据库，所以还需要引入mysql驱动

mysql
mysql-connector-java
8.0.27

三、本地调试

1.debug运行

debug运行SeaTunnelApiExample.java下的主类,

就可以在需要调试的地方断点调试了

2.执行结果

本文由白鲸开源提供发布支持！