Skip to content

[#12682] improve(paimon): document optional Hadoop S3A support for Paimon catalog - #12683

Open
yuqi1129 wants to merge 3 commits into
apache:mainfrom
yuqi1129:fix/12682-paimon-s3a
Open

[#12682] improve(paimon): document optional Hadoop S3A support for Paimon catalog#12683
yuqi1129 wants to merge 3 commits into
apache:mainfrom
yuqi1129:fix/12682-paimon-s3a

Conversation

@yuqi1129

@yuqi1129 yuqi1129 commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

What changes were proposed in this pull request?

Document Hadoop S3A as an optional filesystem for Paimon catalogs, including the required dependencies and configuration.

Add hadoop-aws to the test runtime classpath only, and retain unit and LocalStack integration coverage for an s3a:// Paimon filesystem catalog.

Why are the changes needed?

Paimon native S3 support uses s3:// with paimon-s3. Hadoop S3A is an optional Hadoop-compatible filesystem and requires version-aligned hadoop-aws and aws-java-sdk-bundle JARs in the Paimon catalog classpath.

Packaging these dependencies by default would increase the Paimon catalog package by about 298 MB. Users who need s3a:// can install them explicitly instead.

Fix: #12682

Does this PR introduce any user-facing change?

Yes. The Paimon catalog documentation now explains how to enable and configure optional Hadoop S3A support.

No API or property-key changes are introduced, and S3A dependencies are not included in the production runtime classpath.

How was this patch tested?

  • ./gradlew --no-daemon :catalogs:catalog-lakehouse-paimon:test --tests org.apache.gravitino.catalog.lakehouse.paimon.TestPaimonCatalog.testS3AFileSystemIsAvailable --tests org.apache.gravitino.catalog.lakehouse.paimon.integration.test.CatalogPaimonS3AIT.testAccessS3AFileSystem -PskipDockerTests=false --rerun-tasks
  • Verified that runtimeClasspath does not contain hadoop-aws.
  • Verified that testRuntimeClasspath contains hadoop-aws:3.3.6 and aws-java-sdk-bundle:1.12.367.

Copilot AI lite review requested due to automatic review settings August 27, 2026 14:56

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown

Code Coverage Report

Overall Project 68.47% 🟢
Files changed No Java source files changed -

Module Coverage
aliyun 19.74% 🔴
api 52.07% 🟢
authorization-common 85.96% 🟢
authorization-ranger 4.38% 🔴
aws 53.54% 🟢
azure 32.1% 🔴
catalog-common 9.9% 🔴
catalog-fileset 80.21% 🟢
catalog-glue 69.24% 🟢
catalog-hive 82.96% 🟢
catalog-jdbc-common 45.69% 🟢
catalog-jdbc-doris 82.44% 🟢
catalog-jdbc-mysql 79.33% 🟢
catalog-jdbc-postgresql 83.39% 🟢
catalog-jdbc-starrocks 79.16% 🟢
catalog-kafka 76.99% 🟢
catalog-lakehouse-generic 60.55% 🟢
catalog-lakehouse-hudi 79.1% 🟢
catalog-lakehouse-iceberg 85.86% 🟢
catalog-lakehouse-paimon 84.26% 🟢
catalog-model 77.99% 🟢
cli 44.48% 🟢
client-java 77.44% 🟢
common 55.76% 🟢
core 83.55% 🟢
filesystem-hadoop3 76.45% 🟢
flink 0.0% 🔴
flink-common 50.29% 🟢
flink-runtime 0.0% 🔴
gcp 32.2% 🔴
hadoop-auth 68.0% 🟢
hadoop-common 17.84% 🔴
hive-metastore-common 53.4% 🟢
iceberg-aliyun-bundle 0.0% 🔴
iceberg-common 64.75% 🟢
iceberg-rest-server 75.61% 🟢
idp-basic 85.98% 🟢
integration-test-common 0.0% 🔴
jobs 62.92% 🟢
lance-common 32.63% 🔴
lance-rest-server 63.87% 🟢
lineage 53.02% 🟢
optimizer 83.24% 🟢
optimizer-api 21.95% 🔴
server 88.04% 🟢
server-common 80.5% 🟢
spark 28.57% 🔴
spark-common 48.92% 🟢
tencent 69.84% 🟢
trino-connector 47.44% 🟢

@yuqi1129 yuqi1129 changed the title [#12682] fix(paimon): add Hadoop AWS runtime dependency [#12682] improve(paimon): document optional Hadoop S3A support Aug 28, 2026
@yuqi1129 yuqi1129 self-assigned this Aug 28, 2026
@yuqi1129 yuqi1129 changed the title [#12682] improve(paimon): document optional Hadoop S3A support [#12682] improve(paimon): document optional Hadoop S3A support for Paimon catalog Aug 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug report] Paimon catalog fails to access s3a warehouse because hadoop-aws is missing

2 participants