From 09e89cdb995da28232bb2129defd59813b51d997 Mon Sep 17 00:00:00 2001 From: AlexYinHan Date: Thu, 22 Jan 2026 14:30:58 +0800 Subject: [PATCH] [FLINK-38960][doc] Clarify scope of state compatibility in "Upgrading" documentation --- docs/content.zh/docs/ops/upgrading.md | 3 +++ docs/content/docs/ops/upgrading.md | 5 +++++ 2 files changed, 8 insertions(+) diff --git a/docs/content.zh/docs/ops/upgrading.md b/docs/content.zh/docs/ops/upgrading.md index b5c9340f81ee6..c0740b5abd9a3 100644 --- a/docs/content.zh/docs/ops/upgrading.md +++ b/docs/content.zh/docs/ops/upgrading.md @@ -245,6 +245,9 @@ $ bin/flink run -s :savepointPath [:runArgs] Savepoint 在 Flink 版本之间是兼容的，如下表所示： +***注意***：此处的“兼容”仅指 Savepoint 内部数据格式的兼容性，并不包含 SQL 算子或其他上层改动的兼容性。 +在实践中，只要 Flink SQL 语义没有发生变化，这种状态格式的兼容性通常也能保证作业级别的兼容性。 + diff --git a/docs/content/docs/ops/upgrading.md b/docs/content/docs/ops/upgrading.md index 81251211c027b..133ce4f993775 100644 --- a/docs/content/docs/ops/upgrading.md +++ b/docs/content/docs/ops/upgrading.md @@ -279,6 +279,11 @@ For more details, please take a look at the [savepoint documentation]({{< ref "d Savepoints are compatible across Flink versions as indicated by the table below: +**Note**: "Compatible" here refers specifically to compatibility of the internal data format in +savepoints. It does not cover compatibility of SQL operators or other Upper-level changes. In +practice, provided there are no changes to Flink SQL semantics, this state format compatibility +typically also ensures job-level compatibility. +