Skip to content

[file-index] Support V2 file index container format - #10030

Draft
zjw1111 wants to merge 3 commits into
apache:masterfrom
zjw1111:codex/file-index-v2-format
Draft

zjw1111 wants to merge 3 commits into
apache:masterfrom
zjw1111:codex/file-index-v2-format

Conversation

@zjw1111

@zjw1111 zjw1111 commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Purpose

File index V1 stores index entries before the payloads and uses 32-bit payload positions. This change adds an optional V2 container format that writes payloads before a footer and uses 64-bit start positions and lengths.

Readers remain compatible with V1 and V2. Writers select the format through file-index.format.version, which defaults to V1. Backend payload APIs remain byte-array based in this stage, and readers reject an individual payload whose length exceeds Integer.MAX_VALUE; streaming payload reads and writes will be handled separately.

Tests

Not run yet; compilation and tests were intentionally deferred for this draft.

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.

1 participant