研究paimon catalog,在flink paimon导入数据到s3后,需要用trino去查询。
官方trino没有支持paimon connector,而paimon文档有trino的支持,原理就是将paimon官方的trino插件放到trino的plugin中来让trino支持paimon数据读取。
过程中配置好了trino的paimon catalog,总是报错 HDFS should not be on the plugin classpath ``的问题,根据AI的提示和文档,github社区的问答,找到了关键参数fs.hadoop.enabled=false,跳过hdfs的道路,去访问s3逻辑,最终完成了trino和paimon的集成。
以下是AI整理的笔记,记录一下。
🚀 实战笔记:Trino 440 部署 Paimon 插件及其"去 Hadoop 化"改造
1. 环境背景
-
引擎:Trino 440 (Free tier)
-
存储:私有对象存储 S3 (Seagate)
-
插件:Paimon Trino Connector 1.0-SNAPSHOT
-
核心挑战 :Trino 440 引入了极其严格的 HDFS 依赖隔离机制。只要插件目录下包含 Hadoop 核心包,Trino 就会为了强制推行其 Native S3 策略而拒绝启动。
2. 核心问题轨迹与排查方向
在整个调试过程中,我们经历了一个从"补齐基础类"到"解决框架冲突"的深度排查过程:
阶段一:补齐基础运行环境(Dependency Surgery)
最初,由于尝试移除 hadoop-apache.jar 来躲避检查,导致了大量的类缺失报错。我们手动还原了插件的"血肉":
-
日志/验证层 :补齐了
jboss-logging和classmate。 -
Trino 适配层 :补齐了
trino-hive、trino-orc、trino-parquet等核心包,因为 Paimon 深度复用了 Trino 的这些数据解析逻辑。 -
AWS SDK v2 系列 :由于弃用了 Hadoop 的 S3A 驱动,必须补齐
aws-core、identity-spi、auth、regions等整套 AWS Java SDK 模块。
阶段二:致命的"HDFS 禁令"
当所有依赖看似完整时,遇到了 Trino 440 的硬核校验:
ERROR: HDFS should not be on the plugin classpath
- 原因分析 :Trino 440 的
HdfsFileSystemLoader会扫描 Classpath,只要发现org.apache.hadoop.fs.FileSystem等类,就会判定为非原生驱动。
3. 终极突破:fs.hadoop.enabled=false
在尝试了各种减包手段无效后,通过深入研究 Trino 与文件系统模块的耦合逻辑,找到了决定性的参数:
关键努力与发现
在查阅了大量的 Trino 社区 Issue 及底层源码(FileSystemModule)后,发现 Trino 提供了一个鲜为人知的开关 fs.hadoop.enabled。
-
原理 :该参数默认为
true。当显式设为false后,Trino 的FileSystemManager会跳过对HdfsModule的实例化。 -
结果:这一举动完美绕过了 Trino 的 HDFS 安全扫描逻辑,同时允许 Paimon 独立使用已经补齐的 AWS SDK v2 库直接与 S3 通讯。
4. 最终配置模板 (etc/catalog/paimon.properties)
这是经过反复实验最终成功的配置方案:
Properties
connector.name=paimon
warehouse=s3://your-bucket-name/path
metastore=filesystem
fs.native-s3.enabled=true
# --- 核心避坑参数 ---
# 告诉 Trino 440 彻底禁用 Hadoop 路径扫描,这是启动成功的关键!
fs.hadoop.enabled=false
# --- S3 连接参数 ---
s3.endpoint=https://your-s3-endpoint:9021
s3.region=us-east-1
s3.access-key=YOUR_AK
s3.secret-key=YOUR_SK
s3.path.style.access=true
5. 总结与反思
-
高版本兼容性:Trino 430+ 之后,传统的"塞入 Hadoop 包"做法已经失效。
-
依赖重构 :部署 Paimon 插件不再是简单的"拷贝粘贴",而是一次针对特定 Trino 版本的依赖再平衡。
-
独立驱动意识 :在"去 Hadoop 化"的大趋势下,应优先配置
paimon-s3驱动结合aws-sdk-v2,而非依赖旧的S3A。
笔记结语 :本次成功的关键在于不盲目增删 JAR 包,而是通过定位到
fs.hadoop.enabled这个底层开关,从逻辑上切断了冲突源,实现了 Paimon 在高版本 Trino 环境下的"软着陆"。