Skip to content

[MINOR] docs: Document default ResolvingFileIO - #11511

Merged
mchades merged 1 commit into
apache:mainfrom
qqqttt123:pr-10904-resolving-fileio-docs
Jun 9, 2026
Merged

mchades merged 1 commit into
apache:mainfrom
qqqttt123:pr-10904-resolving-fileio-docs

Conversation

@roryqi

@roryqi roryqi commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

What changes were proposed in this pull request?

Document the default ResolvingFileIO behavior for the Iceberg catalog and Iceberg REST service, including supported URI schemes, explicit overrides, and storage bundle requirements.

Why are the changes needed?

PR #10904 changed the default FileIO behavior, but the existing documentation still states that io-impl has no default value.

Does this PR introduce any user-facing change?

No. This PR only documents the behavior introduced by #10904.

How was this patch tested?

  • ./gradlew spotlessApply
  • ./gradlew :docs:build

@roryqi
roryqi requested a review from yuqi1129 June 9, 2026 04:45
@roryqi roryqi self-assigned this Jun 9, 2026
@roryqi roryqi added the branch-1.3 Automatically cherry-pick commit to branch-1.3 label Jun 9, 2026
@github-actions

github-actions Bot commented Jun 9, 2026 •

Copy link
Copy Markdown

Code Coverage Report

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

Module Coverage
aliyun 1.72% 🔴
api 46.8% 🟢
authorization-common 85.96% 🟢
aws 3.66% 🔴
azure 2.47% 🔴
catalog-common 10.42% 🔴
catalog-fileset 80.35% 🟢
catalog-glue 67.41% 🟢
catalog-hive 79.35% 🟢
catalog-jdbc-clickhouse 80.02% 🟢
catalog-jdbc-common 45.31% 🟢
catalog-jdbc-doris 80.28% 🟢
catalog-jdbc-hologres 54.03% 🟢
catalog-jdbc-mysql 79.23% 🟢
catalog-jdbc-oceanbase 78.38% 🟢
catalog-jdbc-postgresql 82.29% 🟢
catalog-jdbc-starrocks 78.51% 🟢
catalog-kafka 77.01% 🟢
catalog-lakehouse-generic 58.53% 🟢
catalog-lakehouse-hudi 79.1% 🟢
catalog-lakehouse-iceberg 85.86% 🟢
catalog-lakehouse-paimon 79.29% 🟢
catalog-model 77.72% 🟢
cli 44.51% 🟢
client-java 77.91% 🟢
common 50.17% 🟢
core 82.51% 🟢
filesystem-hadoop3 76.97% 🟢
flink 0.0% 🔴
flink-common 46.3% 🟢
flink-runtime 0.0% 🔴
gcp 14.12% 🔴
hadoop-common 10.39% 🔴
hive-metastore-common 53.9% 🟢
iceberg-common 57.41% 🟢
iceberg-rest-server 73.8% 🟢
idp-basic 86.18% 🟢
integration-test-common 0.0% 🔴
jobs 66.17% 🟢
lance-common 20.81% 🔴
lance-rest-server 60.54% 🟢
lineage 53.02% 🟢
optimizer 82.95% 🟢
optimizer-api 21.95% 🔴
server 85.73% 🟢
server-common 73.28% 🟢
spark 28.57% 🔴
spark-common 41.01% 🟢
trino-connector 39.97% 🔴

@roryqi
roryqi requested a review from mchades June 9, 2026 06:10
@roryqi
roryqi force-pushed the pr-10904-resolving-fileio-docs branch from 04b1e6b to d25dd14 Compare June 9, 2026 06:16
Comment thread docs/iceberg-rest-service.md Outdated
the URI scheme: `s3`, `s3a`, or `s3n` for S3; `oss` for OSS; `gs` or `gcs` for GCS;
and `abfs`, `abfss`, `wasb`, or `wasbs` for ADLS. You can explicitly configure
`gravitino.iceberg-rest.io-impl` to override this default. The corresponding storage
bundle must be available in the Iceberg REST server classpath.

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.

Can you use bullet points? That would make it clearer.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Addressed. I converted the URI scheme mapping and related configuration notes to bullet points in both Iceberg documentation pages.

@roryqi
roryqi force-pushed the pr-10904-resolving-fileio-docs branch from d25dd14 to 330ca55 Compare June 9, 2026 07:03
@roryqi
roryqi requested a review from mchades June 9, 2026 07:05
@roryqi

roryqi commented Jun 9, 2026

Copy link
Copy Markdown
Contributor Author

@mchades Could u help me review again?

@mchades
mchades merged commit becbd50 into apache:main Jun 9, 2026
28 checks passed
yuqi1129 pushed a commit that referenced this pull request Jun 10, 2026
…ileIO (#11511) (#11541)

**Cherry-pick Information:**
- Original commit: becbd50
- Target branch: `branch-1.3`
- Status: ✅ Clean cherry-pick (no conflicts)

Co-authored-by: roryqi <roryqi@datastrato.com>
@roryqi
roryqi deleted the pr-10904-resolving-fileio-docs branch June 10, 2026 01:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

branch-1.3 Automatically cherry-pick commit to branch-1.3

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants