Skip to content

refactor(table)!: rename Metadata.Version to FormatVersion - #2317

Merged
zeroshade merged 5 commits into
apache:mainfrom
fallintoplace:refactor/table-format-version-upstream-20261024
Oct 26, 2026
Merged

zeroshade merged 5 commits into
apache:mainfrom
fallintoplace:refactor/table-format-version-upstream-20261024

Conversation

@fallintoplace

Copy link
Copy Markdown
Contributor

What

  • Rename Metadata.Version() to FormatVersion().

Why

  • The name clearly means the Iceberg table format version.

Implementation

  • Update metadata implementations and callers.
  • Keep metadata JSON unchanged.

Refs #2062.

@fallintoplace
fallintoplace marked this pull request as ready for review October 24, 2026 11:34
Signed-off-by: Minh Vu <vuhoangminh97@gmail.com>
@fallintoplace
fallintoplace force-pushed the refactor/table-format-version-upstream-20261024 branch from e29217e to 61be7a6 Compare October 25, 2026 11:19
fallintoplace and others added 4 commits October 25, 2026 15:43
Restore the FormatVersion compatibility note from 61be7a6 dropped by the release-notes sync.
Take main's releases.md; the compatibility note for this change lands in a follow-up release-notes PR so the pre-v1 renames can merge in parallel.

@zeroshade zeroshade left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

FormatVersion() says what it is and matches the view/UDF metadata. Defining it on metadataV1/V2/V3, since it can't share a name with commonMetadata's FormatVersion field, keeps the JSON field and format-version serialization unchanged, and the metadata round-trip tests pass. I pushed a merge of main (6c8d88e); go vet ./... (including -tags integration) and the table, catalog and CLI tests pass. The compatibility note for this change (dropped by the "sync release notes with main" commit) will land in a single follow-up release-notes PR covering this batch of pre-v1 renames, so these can merge in parallel without releases.md conflicts. LGTM.

@zeroshade
zeroshade merged commit 0544baa into apache:main Oct 26, 2026
16 checks passed
zeroshade added a commit to fallintoplace/iceberg-go that referenced this pull request Oct 26, 2026
Resolve the test overlaps with the renames already on main (apache#2308, apache#2314, apache#2317, apache#2319): each conflict hunk keeps this PR's sequence-number names with main's other renames applied.
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.

2 participants