Skip to content

[Iceberg CDC sink] Commit files stage - #40134

Open
ahmedabu98 wants to merge 3 commits into
apache:masterfrom
ahmedabu98:cdc-commit-deltas
Open

ahmedabu98 wants to merge 3 commits into
apache:masterfrom
ahmedabu98:cdc-commit-deltas

Conversation

@ahmedabu98

@ahmedabu98 ahmedabu98 commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

Adds the commit stage. Driven by a stateful DoFn that commits each window's data and equality-delete files as one snapshot.

Includes the following in each snapshot summary for idempotency:

  • sink id
  • token: committed-through window end millis
  • max sequence number in this commit
  • pinned partition spec id

On retry or restart, recovers the token from the table's ancestry to skip already-committed windows, with a heartbeat that keeps the token fresh while the stream is idle.

Part of #39979


Thank you for your contribution! Follow this checklist to help us incorporate your contribution quickly and easily:

  • Mention the appropriate issue in your description (for example: addresses #123), if applicable. This will automatically add a link to the pull request in the issue. If you would like the issue to automatically close on merging the pull request, comment fixes #<ISSUE NUMBER> instead.
  • Update CHANGES.md with noteworthy changes.
  • If this contribution is large, please file an Apache Individual Contributor License Agreement.

See the Contributor Guide for more tips on how to make review process smoother.

To check the build health, please visit https://github.com/apache/beam/blob/master/.test-infra/BUILD_STATUS.md

GitHub Actions Tests Status (on master branch)

Build python source distribution and wheels
Python tests
Java tests
Go tests

See CI.md for more information about GitHub Actions CI or the workflows README to see a list of phrases to trigger workflows.

@github-actions github-actions Bot added java io iceberg Iceberg IO connector labels Sep 15, 2026
@ahmedabu98
ahmedabu98 marked this pull request as ready for review September 17, 2026 10:05
@github-actions

Copy link
Copy Markdown
Contributor

Assigning reviewers:

R: @Abacn for label java.
R: @chamikaramj for label iceberg.

Note: If you would like to opt out of this review, comment assign to next reviewer.

Available commands:

  • stop reviewer notifications - opt out of the automated review tooling
  • remind me after tests pass - tag the comment author after tests pass
  • waiting on author - shift the attention set back to the author (any comment or push by the author will return the attention set to the reviewers)

The PR bot will only process comments in the main thread (not review comments).

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

Thanks!

* as its own single-snapshot commit. A configured {@code tokenHeartbeatMillis} adds an idle
* token-refresh timer ({@link #onHeartbeat}).
*/
static class OrderedCommitFn extends DoFn<KV<String, WindowedCommit>, KV<String, SnapshotInfo>> {

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.

This file is extremely long. Can we move some of the inner classes and interfaces into separate files ? Also add dedicated test classes when appropriate.

// The "commit" timer is always armed at the earliest pending window's end.
long earliestPendingWindowEnd = c.timestamp().getMillis();
// Current input watermark tells us that all past pending windows are safe to commit.
long inputWatermark = timer.getCurrentRelativeTime().getMillis();

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.

This might be runner dependent. Let's adjust or document (if the correctness is preserved).

.apply("KeyByDestination", WithKeys.of(ShardDeltaFiles::getTableIdentifierString))
.setCoder(KvCoder.of(StringUtf8Coder.of(), ShardDeltaFiles.coder()))
// One element per (dest, window): every shard's output for the pair.
.apply("GatherShardsPerWindow", GroupByKey.create())

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.

Do we have to handle late data via after this GBK similar to CommitWindows ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants