Skip to content

[Docs] Add Spark MERGE INTO fields in snapshot summary - #15390

Merged
szehon-ho merged 3 commits into
apache:mainfrom
szehon-ho:doc_summary_new
Feb 26, 2026
Merged

szehon-ho merged 3 commits into
apache:mainfrom
szehon-ho:doc_summary_new

Conversation

@szehon-ho

@szehon-ho szehon-ho commented Feb 21, 2026 •

Copy link
Copy Markdown
Member

Add the snapshot properties added in : #15014 to the Spark docs.

@github-actions github-actions Bot added the Specification Issues that may introduce spec changes. label Feb 21, 2026
@szehon-ho

Copy link
Copy Markdown
Member Author

cc @singhpk234 @amogh-jahagirdar sorry i didnt doc it until now. Btw, it is a trivial change, I think we dont need spec vote?

@szehon-ho

Copy link
Copy Markdown
Member Author

actually not sure it belongs in iceberg core spec, but its suggestion in : #15014 (comment)

@singhpk234 singhpk234 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.

LGTM too, thanks @szehon-ho

my understanding is same too, lets see if folks have opinion otherwise :)

@huaxingao

Copy link
Copy Markdown
Contributor

Since these are Spark-specific fields, it might fit better in docs/docs/spark-writes.md under the ### MERGE INTO section?

@github-actions github-actions Bot added the docs label Feb 21, 2026
@szehon-ho

Copy link
Copy Markdown
Member Author

yea, actually when i was putting the section in spec.md, it seemed a bit off as its engine-specific, so I put in in spark-writes as suggest as @huaxingao

@manuzhang

Copy link
Copy Markdown
Member

@szehon-ho Please update the PR title and description.

@amogh-jahagirdar amogh-jahagirdar changed the title [Spec] Add Spark MERGE INTO fields in snapshot summary [Docs] Add Spark MERGE INTO fields in snapshot summary Feb 22, 2026

@amogh-jahagirdar amogh-jahagirdar 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.

Minor comment on including the version , other than that looks great. Thank you @szehon-ho

Comment thread docs/docs/spark-writes.md

#### Snapshot summary

After a `MERGE INTO` commit, the [snapshot summary](../../spec.md#optional-snapshot-summary-fields) may include the following fields. Each value is the string form of a non-negative count. A field is omitted when the value is unknown (e.g., not reported by Spark).

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.

These new summary fields are produced after Spark 4.1+ right? Should we call that out specifically?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Good catch, done! Sorry for delay

@kevinjqliu kevinjqliu 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.

LGTM rendered locally

Screenshot 2026-02-25 at 9 35 10 PM

@szehon-ho
szehon-ho merged commit 017e813 into apache:main Feb 26, 2026
6 checks passed
@szehon-ho

Copy link
Copy Markdown
Member Author

Thanks @kevinjqliu for checking, @singhpk234 @amogh-jahagirdar @huaxingao @manuzhang for reviews!

RjLi13 pushed a commit to RjLi13/iceberg that referenced this pull request Mar 12, 2026
talatuyarer pushed a commit to talatuyarer/iceberg that referenced this pull request Apr 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Specification Issues that may introduce spec changes.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants