Apache SeaTunnel 数据集成插件开发最新经验总结!

在Apache SeaTunnel的最新插件开发中,connector-v2 maxcompute 连接器实现了基于CatalogTable + SaveMode的新版本。

本文主要给大家分享了源端的关键改动包括弃用了过时的方法,改为通过CatalogTable实现数据传递。汇端则增加了对multi-table sink和saveMode接口的实现,并需手动管理auto service注解等经验方法!

此外,开发了特定的catalog以处理公共参数和客户端操作。

connector-v2 maxcompute 连接器

connector-v2 maxcompute 连接器实现了基于CatalogTable + SaveMode的新版本。

a) 源端的核心改动

  • 新版本中SeaTunnelSource继承自SatunnelPluginLifeCycle接口,其中包含了一个prepare方法。该方法原本用于初始化源端中的config参数,以及一些预处理工作,如删除数据、执行SQL等。
  • SeaTunnelSource中的getProducedType方法用于存储SeatunnelRowType,即列映射转换信息的覆写。

改动如下:

  • 不再使用两个已过时的方法。
  • 在构造函数中创建CatalogTable,并在新方法List<CatalogTable> getProducedCatalogTables()中实现catalog的数据传递。在新版本中,catalogTable将从源端传递到汇端,作为后续saveMode里批量同步建表的SQL拼接来源。
  • SeatunnelRowType可以从catalogTable中获取,以适配现有连接器,也可以自己封装公共参数进行传递。

关于Catalog:

  • 我们通过getTable获取CatalogTable。如果配置了自定义列(column),以适配DataX,我们需要基于column生成CatalogTable

b) SInk端的核心改动

  • MaxcomputeSinkFactory中,额外实现了createSink方法,从上下文中获取catalogReadonlyConfig
  • Sink需要去除auto service注解,并实现multi-table sinksaveMode接口。
  • 基于DefaultSaveModeHandler,通过schemaSaveModeDataSaveMode配置,利用catalog中的方法实现数据清理、建表或个性化操作。
  • catalog实现了truncate table接口,用于数据删除和分区重建。

去除auto_service注解的原因:

  • 如果某个连接器汇端(例如maxcompute)已经实现了新模式接口,不再通过过时的prepare方法注入config,而是通过构造函数从上下文传入的catalogtable获取内部seatunnelRowType的适配。这个连接器在排序上比较靠前,AbstractPluginDiscovery在服务加载时总是首先发现它。但是,如果其他插件(例如clickhouse)仍在使用旧模式(prepare),则MultipleTableJobConfigParser解析汇端会将其视为过时插件,并回退到JobConfigParser进行适配。在parseSink方法中,AbstractPluginDiscovery仍会扫描所有通过autoService注解注入的SeaTunnelSink插件。此时,它遇到的第一个插件maxcompute的构造函数不能适配旧模式的实例初始化,导致失败。
  • 这导致了Maxcompute到Clickhouse数据同步时,报出MaxcomputeSink无法初始化的问题。
  • MaxcomputeSinkWriter需要额外实现SupportMutiTableSinkWriter,否则无法进行适当的转换。

如果要指定部分列回流:

  • 必须比较catalogTable中的列数量与指定的自定义列数量,两者相等才可以进行回流。
  • truncate -> data_save_mode / schema_save_mode
  • 支持列数据的隐式转换(seatunnel row数据是一个Object[]数组,需要结合CatalogTable TableSchema + Opds TableSchema

c) 开发特定的catalog

  • 需要实现公共Catalog接口,其中的openclose可以处理一些公共参数和客户端操作。
  • catalog需要通过catalog factory进行实例化,并通过auto service进行装配加载。

本文由 白鲸开源科技 提供发布支持!

相关推荐
火火PM打怪中2 小时前
产品经理如何绘制服务蓝图(Service Blueprint)
大数据·产品经理
Elastic 中国社区官方博客10 小时前
在 Windows 上使用 Docker 运行 Elastic Open Crawler
大数据·windows·爬虫·elasticsearch·搜索引擎·docker·容器
一切顺势而行11 小时前
Flink cdc 使用总结
大数据·flink
淦暴尼13 小时前
基于spark的二手房数据分析可视化系统
大数据·分布式·数据分析·spark
Ashlee_code14 小时前
裂变时刻:全球关税重构下的券商交易系统跃迁路线图(2025-2027)
java·大数据·数据结构·python·云原生·区块链·perl
Flink_China14 小时前
淘天AB实验分析平台Fluss落地实践:更适合实时OLAP的消息队列
大数据·flink
阿里云大数据AI技术15 小时前
云上AI推理平台全掌握 (4):大模型分发加速
大数据·人工智能·llm
1892280486116 小时前
NW972NW974美光固态闪存NW977NW981
大数据·服务器·网络·人工智能·性能优化
黄雪超16 小时前
Kafka——无消息丢失配置怎么实现?
大数据·分布式·kafka
神策技术社区16 小时前
iOS 全埋点点击事件采集白皮书
大数据·ios·app