Skip to content

[FLINK-40254][docs] Document checkpoint behavior after a CLAIM-mode restore from a NATIVE savepoint - #28838

Open
Savonitar wants to merge 1 commit into
apache:masterfrom
Savonitar:FLINK-40254-docs
Open

[FLINK-40254][docs] Document checkpoint behavior after a CLAIM-mode restore from a NATIVE savepoint#28838
Savonitar wants to merge 1 commit into
apache:masterfrom
Savonitar:FLINK-40254-docs

Conversation

@Savonitar

@Savonitar Savonitar commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Since FLINK-39964, the first incremental checkpoint(s) taken after a CLAIM-mode restore from a NATIVE savepoint reference the reused savepoint files by their absolute location. Extend the CLAIM-mode note on the savepoints page (EN and ZH): such checkpoints are neither self-contained nor relocatable (consistent with incremental checkpoints in general), and the savepoint directory remains referenced, with its files' lifecycle managed by Flink, until every checkpoint reusing its files has been subsumed.

What is the purpose of the change

This pull request updates documents for checkpoint behavior after a CLAIM-mode restore from a NATIVE savepoint.

Brief change log

Update EN and ZH docs.

Verifying this change

This change is a trivial rework / code cleanup without any test coverage.

Does this pull request potentially affect one of the following parts:

  • Dependencies (does it add or upgrade a dependency): (no)
  • The public API, i.e., is any changed class annotated with @Public(Evolving): (no)
  • The serializers: (no)
  • The runtime per-record code paths (performance sensitive): (no)
  • Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn, ZooKeeper: (no)
  • The S3 file system connector: (no)

Documentation

  • Does this pull request introduce a new feature? (no)
  • If yes, how is the feature documented? (docs)

Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)
    Generated-by: Claude Fable 5

@flinkbot

flinkbot commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator

CI report:

Bot commands The @flinkbot bot supports the following commands:
  • @flinkbot run azure re-run the last Azure build

@rkhachatryan rkhachatryan 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

@snuyanzin snuyanzin 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 for contribution

since you use AI, can you use Generated-by: instead of Co-authored-by: as mentioned in Apache recommendations https://www.apache.org/legal/generative-tooling.html

also the doc about this is in https://github.com/apache/flink/pull/27776/changes#r2979585031

…estore from a NATIVE savepoint

Since FLINK-39964, the first incremental checkpoint(s) taken after a
CLAIM-mode restore from a NATIVE savepoint reference the reused savepoint
files by their absolute location. Extend the CLAIM-mode note on the
savepoints page (EN and ZH): such checkpoints are neither self-contained
nor relocatable (consistent with incremental checkpoints in general), and
the savepoint directory remains referenced, with its files' lifecycle
managed by Flink, until every checkpoint reusing its files has been
subsumed.

Generated-by: Claude Fable 5
@Savonitar

Copy link
Copy Markdown
Contributor Author

@snuyanzin thanks for sharing the links. Done!

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.

4 participants