apache / apache/iceberg

Relative Path Support In Table Spec

Open
#13,141 1 comment 20 reactions 0 assignees View on GitHub
Iceberg V4 not-stale proposal
Dominant language
Java
Stars
9.2k
Forks
3.5k
Avg merge
2d 16h
Merged PRs (30d)
129

Description

### Proposed Change

Currently, Iceberg uses absolute URIs for file paths, requiring metadata rewrites when a table is moved.

We want to introduce Relative path which is to achieve "Zero Rewrite Relocation", significantly simplifying table management and portability, with new tables defaulting to relative paths as primary goal.

More details in the document attached.

### Proposal document

https://s.apache.org/iceberg-spec-relative-path

### Specifications

- [x] Table
- [ ] View
- [ ] REST
- [ ] Puffin
- [ ] Encryption
- [ ] Other

Contributor guide

Open the contributing guide

Research direction

Start with the linked proposal document and the Table specification item in the checklist. The issue names no source files or tests, so first determine the implementation scope for relative paths and which parts of the proposal apply to tables. Done should mean the Table portion of the proposal is addressed and its behavior is verifiable.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
data-engineering
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.