You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@flink.apache.org by GitBox <gi...@apache.org> on 2022/02/14 16:45:08 UTC
[GitHub] [flink] akalash opened a new pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
akalash opened a new pull request #18765:
URL: https://github.com/apache/flink/pull/18765
…into documentation
<!--
*Thank you very much for contributing to Apache Flink - we are happy that you want to help us improve Flink. To help the community review your contribution in the best possible way, please go through the checklist below, which will get the contribution into a shape in which it can be best reviewed.*
*Please understand that we do not do this to make contributions to Flink a hassle. In order to uphold a high standard of quality for code contributions, while at the same time managing a large number of contributions, we need contributors to prepare the contributions well, and give reviewers enough contextual information for the review. Please also understand that contributions that do not follow this guide will take longer to review and thus typically be picked up with lower priority by the community.*
## Contribution Checklist
- Make sure that the pull request corresponds to a [JIRA issue](https://issues.apache.org/jira/projects/FLINK/issues). Exceptions are made for typos in JavaDoc or documentation files, which need no JIRA issue.
- Name the pull request in the form "[FLINK-XXXX] [component] Title of the pull request", where *FLINK-XXXX* should be replaced by the actual issue number. Skip *component* if you are unsure about which is the best component.
Typo fixes that have no associated JIRA issue should be named following this pattern: `[hotfix] [docs] Fix typo in event time introduction` or `[hotfix] [javadocs] Expand JavaDoc for PuncuatedWatermarkGenerator`.
- Fill out the template below to describe the changes contributed by the pull request. That will give reviewers the context they need to do the review.
- Make sure that the change passes the automated tests, i.e., `mvn clean verify` passes. You can set up Azure Pipelines CI to do that following [this guide](https://cwiki.apache.org/confluence/display/FLINK/Azure+Pipelines#AzurePipelines-Tutorial:SettingupAzurePipelinesforaforkoftheFlinkrepository).
- Each pull request should address only one issue, not mix up code from multiple issues.
- Each commit in the pull request has a meaningful commit message (including the JIRA id)
- Once all items of the checklist are addressed, remove the above text and this checklist, leaving only the filled out template below.
**(The sections below can be removed for hotfixes of typos)**
-->
## What is the purpose of the change
Moved table with snapshot guarantees clarification from https://cwiki.apache.org/confluence/display/FLINK/FLIP-203%3A+Incremental+savepoints#FLIP203:Incrementalsavepoints-Proposal
## Brief change log
- *Added the table with snapshot guarantees*
## Verifying this change
it is documentation
## Does this pull request potentially affect one of the following parts:
- Dependencies (does it add or upgrade a dependency): (yes / **no**)
- The public API, i.e., is any changed class annotated with `@Public(Evolving)`: (**yes** / no)
- The serializers: (yes / **no** / don't know)
- The runtime per-record code paths (performance sensitive): (yes / **no** / don't know)
- Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn, ZooKeeper: (yes / **no** / don't know)
- The S3 file system connector: (yes / **no** / don't know)
## Documentation
- Does this pull request introduce a new feature? (yes / **no**)
- If yes, how is the feature documented? (not applicable / **docs** / JavaDocs / not documented)
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039313855
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] smattheis commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
smattheis commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812134901
##########
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.
Review comment:
In the link the portion `#state-schema-evolution` is not needed because it's the top-level headline.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] dawidwys commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
dawidwys commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r827117920
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
Review comment:
Haven't we said we want to either update it, or remove it from the current version? @pnowojski
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] smattheis commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
smattheis commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r816799727
##########
File path: docs/content/docs/ops/state/checkpoint_vs_savepoint.md
##########
@@ -0,0 +1,86 @@
+---
+title: "Checkpoint VS Savepoint"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoint_vs_savepoint.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoint VS Savepoint
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+In contrast to all this, Savepoints are created, owned, and deleted by the user.
+Their use-case is for planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+Of course, Savepoints must survive job termination. Conceptually, Savepoints can be a bit more expensive
+to produce and restore and focus more on portability and support for the previously mentioned changes to the job.
+
+### The main checkpoint differences
+
+[Checkpoints]({{< ref "docs/ops/state/checkpoints" >}}) have a few differences from [savepoints]({{< ref "docs/ops/state/savepoints" >}}). They
+- use a state backend specific (low-level) data format, may be incremental. (starting from Flink 1.15 savepoints can also use the backend [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format.)
+- do not support Flink specific features like rescaling.
Review comment:
Yes, that definitely contradicts the information of the table. Could you please clarify that?
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] pnowojski commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
pnowojski commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r829211226
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
Review comment:
I don't remember. Have we?
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* df4cbb123ed4819960a445b05e0fc4e1e8fb473c Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504)
* 0b823c97b46c2575afa10f403e0fa9eb947e98e5 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
}, {
"hash" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652",
"triggerID" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"triggerType" : "PUSH"
}, {
"hash" : "23011f45fa5ea53d3be8522eacff2d2e35dc3039",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33829",
"triggerID" : "23011f45fa5ea53d3be8522eacff2d2e35dc3039",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 23011f45fa5ea53d3be8522eacff2d2e35dc3039 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33829)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812591052
##########
File path: docs/content/docs/ops/state/checkpoints.md
##########
@@ -175,6 +175,35 @@ above).
$ bin/flink run -s :checkpointMetaDataPath [:runArgs]
```
+### Checkpoint/Savepoint guarantees
Review comment:
I wonder whether it should be in its own page titled "Guarantees" or something like that. But I am not sure it fits into the Checkpoints page as it currently stands. I guess we could put it into "Difference to Savepoints" but then the table also has pretty important information and maybe it would stand out more as its own page.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] alpinegizmo commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
alpinegizmo commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r827964351
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
Review comment:
```suggestion
Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
in a way that's analogous to how backups are different from recovery logs in traditional database systems.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
Review comment:
```suggestion
Because Checkpoints are being triggered often, and are relied upon for failure recovery, the two main design goals for the Checkpoint implementation are
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
Review comment:
I don't think it matters how the state backend was configured.
```suggestion
- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring a different State Backend than was used when taking the snapshot.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+- [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.
+- 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.
+- [Schema evolution]({{< ref "docs/dev/datastream/fault-tolerance/serialization/schema_evolution" >}}) - changing the *state* data type.
+- Arbitrary job upgrade - restoring the snapshot with the different [partitioning type]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
+or with the different record type for the existing operator.
Review comment:
```suggestion
- Arbitrary job upgrade - the snapshot can be restored even if the [partitioning types]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
or in-flight record types for the existing operators have changed.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+- [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.
+- 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.
+- [Schema evolution]({{< ref "docs/dev/datastream/fault-tolerance/serialization/schema_evolution" >}}) - changing the *state* data type.
+- Arbitrary job upgrade - restoring the snapshot with the different [partitioning type]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
+or with the different record type for the existing operator.
+- Non-arbitrary job upgrade - restoring the snapshot with the new operator but without changing the graph shape and record types.
+- 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).
Review comment:
```suggestion
- Flink bug/patch version upgrade - restoring a snapshot taken with an older patch version of Flink (1.14.x → 1.14.y).
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
Review comment:
```suggestion
Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from. Their design focuses
more on portability and operational flexibility, especially with respect to changes to the job.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
Review comment:
Given that we support rescaling and forking from retained checkpoints, I think it's potentially confusing to explicitly mention those as motivating use cases for savepoints.
```suggestion
The use case for savepoints is for planned, manual operations. For example, this could be an update of your Flink version, changing your job graph, and so on.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
Review comment:
```suggestion
Optimizations towards those goals can exploit certain properties, e.g., that the job code doesn't change between the execution attempts.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
Review comment:
```suggestion
Checkpoints are usually deleted after the job has been terminated by the user (except if explicitly configured as retained Checkpoints).
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
Review comment:
```suggestion
- ! - While these operations currently work, Flink doesn't officially guarantee support for them, so there is a certain level of risk associated with them
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+- [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.
Review comment:
```suggestion
- [State Processor API (reading)]({{< ref "docs/libs/state_processor_api" >}}#reading-state) - the ability to read states from an existing snapshot of this type via the State Processor API.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
Review comment:
```suggestion
- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create a new snapshot of this type via the State Processor API.
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+- [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.
+- 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.
+- [Schema evolution]({{< ref "docs/dev/datastream/fault-tolerance/serialization/schema_evolution" >}}) - changing the *state* data type.
+- Arbitrary job upgrade - restoring the snapshot with the different [partitioning type]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
+or with the different record type for the existing operator.
+- Non-arbitrary job upgrade - restoring the snapshot with the new operator but without changing the graph shape and record types.
+- Flink minor version upgrade - restoring the snapshot which was taken for the older minor version of Flink (1.x → 1.y).
Review comment:
```suggestion
- Flink minor version upgrade - restoring a snapshot taken with an older minor version of Flink (1.x → 1.y).
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+- [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.
+- 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.
+- [Schema evolution]({{< ref "docs/dev/datastream/fault-tolerance/serialization/schema_evolution" >}}) - changing the *state* data type.
Review comment:
```suggestion
- [Schema evolution]({{< ref "docs/dev/datastream/fault-tolerance/serialization/schema_evolution" >}}) - the *state* data type can be changed if it uses a serializer that supports schema evolution (e.g., POJOs and Avro types)
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+- [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.
+- 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.
+- [Schema evolution]({{< ref "docs/dev/datastream/fault-tolerance/serialization/schema_evolution" >}}) - changing the *state* data type.
+- Arbitrary job upgrade - restoring the snapshot with the different [partitioning type]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
+or with the different record type for the existing operator.
+- Non-arbitrary job upgrade - restoring the snapshot with the new operator but without changing the graph shape and record types.
Review comment:
```suggestion
- Non-arbitrary job upgrade - restoring the snapshot is possible with updated operators if the job graph topology and in-flight record types remain unchanged.
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812597693
##########
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 |
Review comment:
```suggestion
| State backend change | Supported | NOT Supported | NOT Supported | NOT Supported |
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] Myasuka commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
Myasuka commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812734322
##########
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 |
Review comment:
From current implementation, can current RocksDB native savepoint supports relocatable? I doubted this.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] smattheis commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
smattheis commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812185484
##########
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.
Review comment:
A nice introductory sentence would be good and maybe a bit more positive. :) E.g.:
"The ability to store and restore an application's state is an essential and powerful feature of Flink. However, it also has limitations when it comes to changes in the application or Flink configuration. The following table gives an overview of capabilities and limitiations for the various types of savepoints and checkpoints."
##########
File path: docs/content/docs/ops/state/checkpoints.md
##########
@@ -175,6 +175,35 @@ above).
$ bin/flink run -s :checkpointMetaDataPath [:runArgs]
```
+### Checkpoint/Savepoint guarantees
Review comment:
Should we combine it with the section "Difference to Savepoints"?
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
* 4d20c285ada88052e56d5293d69091ae088b53f7 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039323929
@infoverload, I need help with the design of this documentation. The idea is to have approximately the same table as here - https://cwiki.apache.org/confluence/display/FLINK/FLIP-203%3A+Incremental+savepoints#FLIP203:Incrementalsavepoints-Proposal.
So my questions:
- if you think that the background color makes sense here how I can do so? should I use HTML or I should do it in markdown?
- How correctly clarify the meaning of each line? Right now, I provide the cross-link to other pages where it was possible but I don't sure what to do with the rest ones - expanding definition directly in table or do it under the table.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r827104764
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
Review comment:
I think yes, according to FLIP(https://cwiki.apache.org/confluence/display/FLINK/FLIP-203%3A+Incremental+savepoints#FLIP203:Incrementalsavepoints-Proposal) Canonical Savepoint is supported while all others are unofficially supported.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812595920
##########
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.
+- Arbitrary job upgrade - restoring the snapshot with the different [partitioning type]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
+or with the different record type for the existing operator.
+- Job upgrade w/o changing graph shape and record types - restoring the snapshot with new operator but without changes described above.
+- Rescaling - restoring the snapshot with a different parallelism that was during the snapshot creating.
Review comment:
```suggestion
- Rescaling - restoring the snapshot with a different parallelism than was used during the snapshot creation
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
* 4d20c285ada88052e56d5293d69091ae088b53f7 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 4d20c285ada88052e56d5293d69091ae088b53f7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0b823c97b46c2575afa10f403e0fa9eb947e98e5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1070856975
@alpinegizmo , thanks a lot for your suggestions. I have made changes. Please, take a look once again when you have time.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812599908
##########
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.
Review comment:
```suggestion
- [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.
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r813123021
##########
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 |
Review comment:
Don't worry. Thanks, for rechecking it. I am glad that everything is correct.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r813113242
##########
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.
+
Review comment:
Discussable. But I personally don't think that grouping makes sense here since this grouping is not natural. I mean having groups doesn't give us or users more understanding or advantages. for example, if we could say that we support all types of snapshot for group 'Application changes' but only native savepoint for group 'Configuration changes' it would be useful. But in the current implementation, it will give us only more lines in the table
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 4d20c285ada88052e56d5293d69091ae088b53f7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252)
* df4cbb123ed4819960a445b05e0fc4e1e8fb473c Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r814858315
##########
File path: docs/content/docs/ops/state/checkpoint_vs_savepoint.md
##########
@@ -0,0 +1,86 @@
+---
+title: "Checkpoint VS Savepoint"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoint_vs_savepoint.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoint VS Savepoint
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+In contrast to all this, Savepoints are created, owned, and deleted by the user.
+Their use-case is for planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+Of course, Savepoints must survive job termination. Conceptually, Savepoints can be a bit more expensive
+to produce and restore and focus more on portability and support for the previously mentioned changes to the job.
+
+### The main checkpoint differences
+
+[Checkpoints]({{< ref "docs/ops/state/checkpoints" >}}) have a few differences from [savepoints]({{< ref "docs/ops/state/savepoints" >}}). They
+- use a state backend specific (low-level) data format, may be incremental. (starting from Flink 1.15 savepoints can also use the backend [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format.)
+- do not support Flink specific features like rescaling.
Review comment:
I am not really sure that it is true now.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8b902f32828d65783a1b61a533228cdc39271e92 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442)
* 1a32563b7691d8e8d795fd1adbbc830d283fd3d3 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 1a32563b7691d8e8d795fd1adbbc830d283fd3d3 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
* 4d20c285ada88052e56d5293d69091ae088b53f7 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 4d20c285ada88052e56d5293d69091ae088b53f7 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252)
* df4cbb123ed4819960a445b05e0fc4e1e8fb473c UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8b902f32828d65783a1b61a533228cdc39271e92 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812593954
##########
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 |
Review comment:
I think we should definitely avoid color for this table (more user-friendly and more accessible to people who might be color-blind, etc) but we could consider using an abbreviation or a symbol to represent "Supported", "NOT Supported", and "Experimentally Supported" to make the entire table less wordy and cramped.
For example, we could use "✓", "x", "!" and then have a legend for that beforehand.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812594170
##########
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.
+
Review comment:
I like the idea of grouping if these groups make sense
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1048492576
I think expanding the definitions under the table is fine.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r813104250
##########
File path: docs/content/docs/ops/state/checkpoints.md
##########
@@ -175,6 +175,35 @@ above).
$ bin/flink run -s :checkpointMetaDataPath [:runArgs]
```
+### Checkpoint/Savepoint guarantees
Review comment:
Yes, I also thought about the extra page for this information but I also wasn't sure to worth it or not.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] smattheis commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
smattheis commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812188285
##########
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.
+
Review comment:
Would it make sense to group the table rows in, e.g., (just an idea):
```
Application changes
- Job upgrade (?)
- Artibrary job upgrade (?)
- Schema evoluation
State management
- Self-contained and relocatable
- State processor API (reading)
- State processor API (writing)
Configuration changes
- State backend migration
- Minor version migration
- Bugfix/patch
- Rescaling
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0b823c97b46c2575afa10f403e0fa9eb947e98e5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118)
* 398ae38541907b84085c19d0a889da961b8d82d3 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 1a32563b7691d8e8d795fd1adbbc830d283fd3d3 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873)
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
* 4d20c285ada88052e56d5293d69091ae088b53f7 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039313855
Thanks a lot for your contribution to the Apache Flink project. I'm the @flinkbot. I help the community
to review your pull request. We will use this comment to track the progress of the review.
## Automated Checks
Last check on commit 8b902f32828d65783a1b61a533228cdc39271e92 (Mon Feb 14 16:49:37 UTC 2022)
**Warnings:**
* Documentation files were touched, but no `docs/content.zh/` files: Update Chinese documentation or file Jira ticket.
<sub>Mention the bot in a comment to re-run the automated checks.</sub>
## Review Progress
* ❓ 1. The [description] looks good.
* ❓ 2. There is [consensus] that the contribution should go into to Flink.
* ❓ 3. Needs [attention] from.
* ❓ 4. The change fits into the overall [architecture].
* ❓ 5. Overall code [quality] is good.
Please see the [Pull Request Review Guide](https://flink.apache.org/contributing/reviewing-prs.html) for a full explanation of the review process.<details>
The Bot is tracking the review progress through labels. Labels are applied according to the order of the review items. For consensus, approval by a Flink committer of PMC member is required <summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot approve description` to approve one or more aspects (aspects: `description`, `consensus`, `architecture` and `quality`)
- `@flinkbot approve all` to approve all aspects
- `@flinkbot approve-until architecture` to approve everything until `architecture`
- `@flinkbot attention @username1 [@username2 ..]` to require somebody's attention
- `@flinkbot disapprove architecture` to remove an approval you gave earlier
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039323929
@infoverload, I need help with the design of this documentation. The idea is to have approximately the same table as here - https://cwiki.apache.org/confluence/display/FLINK/FLIP-203%3A+Incremental+savepoints#FLIP203:Incrementalsavepoints-Proposal.
So my questions:
- if you think that the background color makes sense here how I can do so? should I use HTML or I should do it in markdown?
- How correctly clarify the meaning of each line? Right now, I provide the cross-link to other pages where it was possible but I don't sure what to do with the rest ones - expanding definition directly in table or do it under the table.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812599226
##########
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.
+- Arbitrary job upgrade - restoring the snapshot with the different [partitioning type]({{< ref "docs/dev/datastream/operators/overview" >}}#physical-partitioning)(rescale, rebalance, map, etc.)
+or with the different record type for the existing operator.
+- Job upgrade w/o changing graph shape and record types - restoring the snapshot with new operator but without changes described above.
Review comment:
```suggestion
- Non-arbitrary job upgrade - restoring the snapshot with the new operator but without changing the graph shape and record types
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
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 (1.x → 1.y) - restoring the snapshot which was taken for the older minor version of Flink.
- Flink bug/patch version upgrade (1.14.x → 1.14.y) - restoring the snapshot which was taken for the older patch version of Flink.
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812591710
##########
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.
Review comment:
+1
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1058166996
@smattheis , I have not applied all of your suggestions but I have applied some of the ideas. So please, take a look again when you have time
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] smattheis commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
smattheis commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r817857700
##########
File path: docs/content/docs/ops/state/checkpoints.md
##########
@@ -35,6 +35,8 @@ the same semantics as a failure-free execution.
See [Checkpointing]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) for how to enable and
configure checkpoints for your program.
+See [Checkpoint VS Savepoint]({{< ref "docs/ops/state/checkpoint_vs_savepoint" >}}) for understanding the differences with [Savepoints]({{< ref "docs/ops/state/savepoints" >}}).
Review comment:
```suggestion
To understand the differences between checkpoints and [savepoints]({{< ref "docs/ops/state/savepoints" >}}) see [checkpoints vs. savepoints]({{< ref "docs/ops/state/checkpoint_vs_savepoint" >}}).
```
##########
File path: docs/content/docs/ops/state/checkpoint_vs_savepoint.md
##########
@@ -0,0 +1,86 @@
+---
+title: "Checkpoint VS Savepoint"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoint_vs_savepoint.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoint VS Savepoint
Review comment:
```suggestion
# Checkpoints vs. savepoints
## Overview
[Savepoints]({{< ref "docs/ops/state/savepoints" >}}) and [checkpoints]({{< ref "docs/ops/state/checkpoints" >}}) are two
different ways to snapshot an application's state. The differences arise as both address different use cases which
come with different design goals and therefore different optimizations.
The primary use case for checkpoints is to provide a recovery mechanism in case of unexpected job failures.
The [checkpoint lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is configurable but
managed by Flink, i.e., checkpoints are created, owned, and released by Flink - without user interaction. More
specifically, checkpoints are created periodically to allow fast state recovery at any time and are eventually deleted
when no longer needed. The main design goal is to make checkpoints as fast as possible to be created and restored.
The optimizations, however, limit their flexibility such that applications must not change between creation and recovery.
Checkpoints have the following characteristics:
- fast to create and restore for fast failure recovery
- limited flexibility/usability for other use cases
- managed by Flink runtime
- stored in state backend-specific (native) data format (may be incremental depending on the specific backend)
Note: Checkpoints are automatically deleted if the application is terminated by the user (except if checkpoints are
explicitly configured to be retained).
Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
checkpoints, they are conceptually different and designed for flexibility and portability in application maintenance
and operation. The primary use case is a planned and manual backup and resume of an application's state.
Savepoints enable, e.g., Flink version updates, job graph changes, configuration changes like parallelism, or forking a second job as in red/blue deployment.
As a consequence, savepoints are slower to create and restore than checkpoints. Also savepoints are created, owned
and deleted solely by the user. That means, Flink does not delete savepoints neither after job termination nor after
restore.
Savepoints have the following characteristics:
- slower to create and restore than checkpoints
- support flexibility and portability for application maintenance and operation
- managed by the user
- stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
and restore but comes with some limitations.)
## Capabilities and limitations
The following table gives an overview of capabilities and limitations for the various types of savepoints and
checkpoints.
```
```
##########
File path: docs/content/docs/ops/state/checkpoint_vs_savepoint.md
##########
@@ -0,0 +1,86 @@
+---
+title: "Checkpoint VS Savepoint"
Review comment:
```suggestion
title: "Checkpoint vs. savepoints"
```
##########
File path: docs/content/docs/ops/state/savepoints.md
##########
@@ -37,14 +37,7 @@ image. The meta data file of a Savepoint contains (primarily) pointers to all fi
In order to allow upgrades between programs and Flink versions, it is important to check out the following section about [assigning IDs to your operators](#assigning-operator-ids).
{{< /hint >}}
-Conceptually, Flink's Savepoints are different from Checkpoints in a similar way that backups are different from recovery logs in traditional database systems. The primary purpose of Checkpoints is to provide a recovery mechanism in case of
-unexpected job failures. A Checkpoint's lifecycle is managed by Flink, i.e. a Checkpoint is created, owned, and released by Flink - without user interaction. As a method of recovery and being periodically triggered, two main
-design goals for the Checkpoint implementation are i) being as lightweight to create and ii) being as fast to restore from as possible. Optimizations towards those goals can exploit certain properties, e.g. that the job code
-doesn't change between the execution attempts. Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
-
-In contrast to all this, Savepoints are created, owned, and deleted by the user. Their use-case is for planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
-changing parallelism, forking a second job like for a red/blue deployment, and so on. Of course, Savepoints must survive job termination. Conceptually, Savepoints can be a bit more expensive to produce and restore and focus
-more on portability and support for the previously mentioned changes to the job.
+See [Checkpoint VS Savepoint]({{< ref "docs/ops/state/checkpoint_vs_savepoint" >}}) for understanding the differences with [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}}).
Review comment:
```suggestion
To make proper use of savepoints, it's important to understand the differences between [checkpoints]({{< ref "docs/ops/state/checkpoints" >}}) and savepoints which is described in [checkpoints vs. savepoints]({{< ref "docs/ops/state/checkpoint_vs_savepoint" >}}).
```
##########
File path: docs/content/docs/concepts/stateful-stream-processing.md
##########
@@ -311,7 +311,7 @@ mechanism for this.
Savepoints are similar to checkpoints except that they are
**triggered by the user** and **don't automatically expire** when newer
-checkpoints are completed.
+checkpoints are completed(see [Checkpoint VS Savepoint]({{< ref "docs/ops/state/checkpoint_vs_savepoint" >}}) for all differences).
Review comment:
```suggestion
checkpoints are completed. To make proper use of savepoints, it's important to understand the differences between [checkpoints]({{< ref "docs/ops/state/checkpoints" >}}) and [savepoints]({{< ref "docs/ops/state/savepoints" >}}) which is described in [checkpoints vs. savepoints]({{< ref "docs/ops/state/checkpoint_vs_savepoint" >}}).
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0b823c97b46c2575afa10f403e0fa9eb947e98e5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118)
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
}, {
"hash" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 544f3f88ca286ed94402aa4524b30fdb24554609 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252)
* 9e4a769224c9f666a6a6345fd2a6aaafb69acdcf UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
}, {
"hash" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652",
"triggerID" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"triggerType" : "PUSH"
}, {
"hash" : "23011f45fa5ea53d3be8522eacff2d2e35dc3039",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33829",
"triggerID" : "23011f45fa5ea53d3be8522eacff2d2e35dc3039",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 9e4a769224c9f666a6a6345fd2a6aaafb69acdcf Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652)
* 23011f45fa5ea53d3be8522eacff2d2e35dc3039 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33829)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8b902f32828d65783a1b61a533228cdc39271e92 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 1a32563b7691d8e8d795fd1adbbc830d283fd3d3 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873)
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] Myasuka commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
Myasuka commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812943849
##########
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 |
Review comment:
I checked with latest master branch, and the native checkpoint works fine. Sorry to bother here.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r818625043
##########
File path: docs/content/docs/ops/state/checkpoint_vs_savepoint.md
##########
@@ -0,0 +1,86 @@
+---
+title: "Checkpoint VS Savepoint"
Review comment:
I don't really see the difference between `VS` and `vs.` according to grammatic `VS`, `or.`, `vs` and `v.` are equal. I like `VS` more since it looks more explicit in the title
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] alpinegizmo commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
alpinegizmo commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r833087856
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,96 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a way that's analogous to how backups are different from recovery logs in traditional database systems.
+
+The primary purpose of checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a checkpoint is created, owned, and released by Flink - without user interaction.
+Because checkpoints are being triggered often, and are relied upon for failure recovery, the two main design goals for the checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g., that the job code doesn't change between the execution attempts.
+Checkpoints are usually deleted after the job has been terminated by the user (except if explicitly configured as retained checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from. Their design focuses
+more on portability and operational flexibility, especially with respect to changes to the job.
+The use case for savepoints is for planned, manual operations. For example, this could be an update of your Flink version, changing your job graph, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - While these operations currently work, Flink doesn't officially guarantee support for them, so there is a certain level of risk associated with them
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
Review comment:
```suggestion
| State Processor API (writing) | ✓ | x | x | x |
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,96 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a way that's analogous to how backups are different from recovery logs in traditional database systems.
+
+The primary purpose of checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a checkpoint is created, owned, and released by Flink - without user interaction.
+Because checkpoints are being triggered often, and are relied upon for failure recovery, the two main design goals for the checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g., that the job code doesn't change between the execution attempts.
+Checkpoints are usually deleted after the job has been terminated by the user (except if explicitly configured as retained checkpoints).
Review comment:
This sentence is redundant with the line below; seems like we don't need it twice.
```suggestion
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,96 @@
+---
+title: "Checkpoints VS Savepoints"
Review comment:
```suggestion
title: "Checkpoints vs. Savepoints"
```
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,96 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a way that's analogous to how backups are different from recovery logs in traditional database systems.
+
+The primary purpose of checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a checkpoint is created, owned, and released by Flink - without user interaction.
+Because checkpoints are being triggered often, and are relied upon for failure recovery, the two main design goals for the checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g., that the job code doesn't change between the execution attempts.
+Checkpoints are usually deleted after the job has been terminated by the user (except if explicitly configured as retained checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from. Their design focuses
+more on portability and operational flexibility, especially with respect to changes to the job.
+The use case for savepoints is for planned, manual operations. For example, this could be an update of your Flink version, changing your job graph, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - While these operations currently work, Flink doesn't officially guarantee support for them, so there is a certain level of risk associated with them
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
Review comment:
```suggestion
| State Processor API (reading) | ✓ | ! | ! | x |
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
}, {
"hash" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652",
"triggerID" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"triggerType" : "PUSH"
}, {
"hash" : "23011f45fa5ea53d3be8522eacff2d2e35dc3039",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "23011f45fa5ea53d3be8522eacff2d2e35dc3039",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 9e4a769224c9f666a6a6345fd2a6aaafb69acdcf Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652)
* 23011f45fa5ea53d3be8522eacff2d2e35dc3039 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 0b823c97b46c2575afa10f403e0fa9eb947e98e5 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118)
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1070856975
@alpinegizmo , thanks a lot for your suggestions. I have made changes. Please, take a look once again when you have time.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] pnowojski merged pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
pnowojski merged pull request #18765:
URL: https://github.com/apache/flink/pull/18765
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
}, {
"hash" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"status" : "PENDING",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652",
"triggerID" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 544f3f88ca286ed94402aa4524b30fdb24554609 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252)
* 9e4a769224c9f666a6a6345fd2a6aaafb69acdcf Azure: [PENDING](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
}, {
"hash" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652",
"triggerID" : "9e4a769224c9f666a6a6345fd2a6aaafb69acdcf",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 9e4a769224c9f666a6a6345fd2a6aaafb69acdcf Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33652)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] dawidwys commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
dawidwys commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r826988366
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
Review comment:
Are the values for `Schema evolution` correct?
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* df4cbb123ed4819960a445b05e0fc4e1e8fb473c Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504)
* 0b823c97b46c2575afa10f403e0fa9eb947e98e5 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] dawidwys commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
dawidwys commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r827117920
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
Review comment:
Haven't we said we want to either update it, or remove it from the current version of the table? @pnowojski
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 544f3f88ca286ed94402aa4524b30fdb24554609 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33252)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1044682157
@dawidwys, I have added the description to each table line under the table. I don't think that my clarification is perfect but it is all that I have. So if you have ideas on how to make it more clear, please, share them with me. Also, if you know doc pages to which I can link, give me know.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812598191
##########
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 |
Review comment:
```suggestion
| Non-arbitrary job upgrade | Supported | Supported | Supported | NOT Supported |
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812597875
##########
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 |
Review comment:
```suggestion
| Flink minor version upgrade | Supported | Supported | Supported | NOT Supported |
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* df4cbb123ed4819960a445b05e0fc4e1e8fb473c Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8b902f32828d65783a1b61a533228cdc39271e92 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "SUCCESS",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 8b902f32828d65783a1b61a533228cdc39271e92 Azure: [SUCCESS](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442)
* 1a32563b7691d8e8d795fd1adbbc830d283fd3d3 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] akalash commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
akalash commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1055506056
@smattheis, since the branch is from in my personal repository, it will be not convenient for you to add new commits on top. I think we usually use something like `add a suggestion` in PR for such things.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] dawidwys commented on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
dawidwys commented on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1050963987
This is the cli page: https://nightlies.apache.org/flink/flink-docs-master/docs/deployment/cli/#creating-a-savepoint and this is a pending PR I mentioned: https://github.com/apache/flink/pull/18900
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "FAILURE",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 1a32563b7691d8e8d795fd1adbbc830d283fd3d3 Azure: [FAILURE](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873)
* d3d6c2eb1ed64b15f57c4324a2d6710602661923 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] infoverload commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
infoverload commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r812597946
##########
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 |
Review comment:
```suggestion
| Flink bug/patch version upgrade | Supported | Supported | Supported | Supported |
```
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] dawidwys commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
dawidwys commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r827003645
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
+| Arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Non-arbitrary job upgrade | ✓ | ✓ | ✓ | x |
+| Flink minor version upgrade | ✓ | ✓ | ✓ | x |
+| Flink bug/patch version upgrade | ✓ | ✓ | ✓ | ✓ |
+| Rescaling | ✓ | ✓ | ✓ | ✓ |
+
+- [State backend change]({{< ref "docs/ops/state/state_backends" >}}) - configuring different State Backend via `state.backend` parameter than it was during the taking snapshot.
+- [State Processor API (writing)]({{< ref "docs/libs/state_processor_api" >}}#writing-new-savepoints) - the ability to create new snapshot via State Processor API.
+and it doesn't depend on other snapshots which means it can be easily moved to another place if needed.
Review comment:
This line seems to be out of place.
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] pnowojski commented on a change in pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
pnowojski commented on a change in pull request #18765:
URL: https://github.com/apache/flink/pull/18765#discussion_r829211226
##########
File path: docs/content/docs/ops/state/checkpoints_vs_savepoints.md
##########
@@ -0,0 +1,97 @@
+---
+title: "Checkpoints VS Savepoints"
+weight: 10
+type: docs
+aliases:
+ - /ops/state/checkpoints_vs_savepoints.html
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Checkpoints VS Savepoints
+
+## Overview
+
+Conceptually, Flink's [Savepoints]({{< ref "docs/ops/state/savepoints" >}}) are different from [Checkpoints]({{< ref "docs/ops/state/checkpoints" >}})
+in a similar way that backups are different from recovery logs in traditional database systems.
+
+The primary purpose of Checkpoints is to provide a recovery mechanism in case of unexpected job failures.
+A [Checkpoint's lifecycle]({{< ref "docs/dev/datastream/fault-tolerance/checkpointing" >}}) is managed by Flink,
+i.e. a Checkpoint is created, owned, and released by Flink - without user interaction.
+As a method of recovery and being periodically triggered, two main design goals for the Checkpoint implementation are
+i) being as lightweight to create and ii) being as fast to restore from as possible.
+Optimizations towards those goals can exploit certain properties, e.g. that the job code doesn't change between the execution attempts.
+Checkpoints are usually dropped after the job was terminated by the user (except if explicitly configured as retained Checkpoints).
+
+{{< hint info >}}
+- Checkpoints are automatically deleted if the application is terminated by the user
+(except if checkpoints are explicitly configured to be retained).
+- Checkpoints are stored in state backend-specific (native) data format (may be incremental depending on the specific backend).
+{{< /hint >}}
+
+Although [savepoints]({{< ref "docs/ops/state/savepoints" >}}) are created internally with the same mechanisms as
+checkpoints, they are conceptually different and can be a bit more expensive to produce and restore from and focus
+more on portability and flexibility with respect to changes to the job.
+Their use case is planned, manual backup and resume. For example, this could be an update of your Flink version, changing your job graph,
+changing parallelism, forking a second job like for a red/blue deployment, and so on.
+
+{{< hint info >}}
+- Savepoints are created, owned and deleted solely by the user.
+That means, Flink does not delete savepoints neither after job termination nor after
+restore.
+- Savepoints are stored in a state backend independent (canonical) format (Note: Since Flink 1.15, savepoints can be also stored in
+the backend-specific [native]({{< ref "docs/ops/state/savepoints" >}}#savepoint-format) format which is faster to create
+and restore but comes with some limitations.
+{{< /hint >}}
+
+### Capabilities and limitations
+The following table gives an overview of capabilities and limitations for the various types of savepoints and
+checkpoints.
+- ✓ - Flink fully support this type of the snapshot
+- x - Flink doesn't support this type of the snapshot
+- ! - in fact, Flink support this type but officially, Flink doesn't support this type of the snapshot(there is certain level of risk to use it)
+
+| Operation | Canonical Savepoint | Native Savepoint | Aligned Checkpoint | Unaligned Checkpoint |
+|:--------------------------------|:--------------------|:-----------------|:-------------------|:---------------------|
+| State backend change | ✓ | x | x | x |
+| State Processor API(writing) | ✓ | x | x | x |
+| State Processor API(reading) | ✓ | ! | ! | x |
+| Self-contained and relocatable | ✓ | ✓ | x | x |
+| Schema evolution | ✓ | ! | ! | ! |
Review comment:
I don't remember. Have we?
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [flink] flinkbot edited a comment on pull request #18765: [FLINK-26134][docs] Added table with Checkpoint/Savepoint guarantees …
Posted by GitBox <gi...@apache.org>.
flinkbot edited a comment on pull request #18765:
URL: https://github.com/apache/flink/pull/18765#issuecomment-1039315828
<!--
Meta data
{
"version" : 1,
"metaDataEntries" : [ {
"hash" : "8b902f32828d65783a1b61a533228cdc39271e92",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31442",
"triggerID" : "8b902f32828d65783a1b61a533228cdc39271e92",
"triggerType" : "PUSH"
}, {
"hash" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=31873",
"triggerID" : "1a32563b7691d8e8d795fd1adbbc830d283fd3d3",
"triggerType" : "PUSH"
}, {
"hash" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32241",
"triggerID" : "d3d6c2eb1ed64b15f57c4324a2d6710602661923",
"triggerType" : "PUSH"
}, {
"hash" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32252",
"triggerID" : "4d20c285ada88052e56d5293d69091ae088b53f7",
"triggerType" : "PUSH"
}, {
"hash" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=32504",
"triggerID" : "df4cbb123ed4819960a445b05e0fc4e1e8fb473c",
"triggerType" : "PUSH"
}, {
"hash" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"status" : "DELETED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33118",
"triggerID" : "0b823c97b46c2575afa10f403e0fa9eb947e98e5",
"triggerType" : "PUSH"
}, {
"hash" : "398ae38541907b84085c19d0a889da961b8d82d3",
"status" : "CANCELED",
"url" : "https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241",
"triggerID" : "398ae38541907b84085c19d0a889da961b8d82d3",
"triggerType" : "PUSH"
}, {
"hash" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"status" : "UNKNOWN",
"url" : "TBD",
"triggerID" : "544f3f88ca286ed94402aa4524b30fdb24554609",
"triggerType" : "PUSH"
} ]
}-->
## CI report:
* 398ae38541907b84085c19d0a889da961b8d82d3 Azure: [CANCELED](https://dev.azure.com/apache-flink/98463496-1af2-4620-8eab-a2ecc1a2e6fe/_build/results?buildId=33241)
* 544f3f88ca286ed94402aa4524b30fdb24554609 UNKNOWN
<details>
<summary>Bot commands</summary>
The @flinkbot bot supports the following commands:
- `@flinkbot run azure` re-run the last Azure build
</details>
--
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: issues-unsubscribe@flink.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org