infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812595377
##########
File path: docs/content/docs/ops/state/checkpoints.md
##########
@@ -175,6 +175,35 @@ above).
$ bin/flink run -s :checkpointMetaDataPath [:runArgs]
```
+### Checkpoint/Savepoint guarantees
+Not always the snapshot can be successfully restored.
+The following list contains operations which can be done without recovery lose
depends on the type of the snapshot.
+
+| Operation | Canonical Savepoint
| Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint
|
+|:------------------------------------------------------|:--------------------|:-------------------------|:-------------------------|:-------------------------|
+| Statebackend change | Supported
| NOT Supported | NOT Supported | NOT Supported
|
+| Self-contained and relocatable | Supported
| Supported | NOT Supported | NOT Supported
|
+| State Processor API(reading) | Supported
| Experimentally Supported | Experimentally Supported | NOT Supported
|
+| State Processor API(writing) | Supported
| NOT Supported | NOT Supported | NOT Supported
|
+| Schema evolution | Supported
| Experimentally Supported | Experimentally Supported | Experimentally
Supported |
+| Flink minor (1.x → 1.y) version upgrade | Supported
| Supported | Supported | NOT Supported
|
+| Flink bug/patch (1.14.x → 1.14.y) version upgrade | Supported
| Supported | Supported | Supported
|
+| Arbitrary job upgrade | Supported
| Supported | Supported | NOT Supported
|
+| Job upgrade w/o changing graph shape and record types | Supported
| Supported | Supported | NOT Supported
|
+| Rescaling | Supported
| Supported | Supported | Supported
|
+
+- [Statebackend change]({{< ref "docs/ops/state/state_backends" >}}) -
configuring different State Backend via `state.backend` parameter than it was
during the taking snapshot.
+- Self-contained and relocatable - the one snapshot folder contains everything
it needs for recovery.
+and it doesn't depend on other snapshots which means it can be easily moved to
another place if needed.
+- [State Processor API(reading)]({{< ref "docs/libs/state_processor_api"
>}}#reading-state) - the ability to read states from the existing snapshot via
State Processor API.
+- [State Processor API(writing)]({{< ref "docs/libs/state_processor_api"
>}}#writing-new-savepoints) - the ability to create new snapshot via State
Processor API.
+- [Schema evolution]({{< ref
"docs/dev/datastream/fault-tolerance/serialization/schema_evolution"
>}}#state-schema-evolution) - changing the *state* data type.
+- Flink minor (1.x → 1.y) version upgrade - restoring the snapshot which was
taken for the older minor version of flink.
+- Flink bug/patch (1.14.x → 1.14.y) version upgrade - restoring the snapshot
which was taken for the older patch version of flink.
Review comment:
```suggestion
- Flink minor version upgrade - restoring the snapshot which was taken for
the older minor version of Flink (1.x → 1.y)
- Flink bug/patch version upgrade - restoring the snapshot which was taken
for the older patch version of Flink (1.14.x → 1.14.y)
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
