You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@flink.apache.org by "Weiqing Yang (Jira)" <ji...@apache.org> on 2025/08/14 05:51:00 UTC

[jira] [Updated] (FLINK-38242) Improve upgrading documentation for SQL/Table API state compatibility and add Flink 2.x to compatibility table

     [ https://issues.apache.org/jira/browse/FLINK-38242?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Weiqing Yang updated FLINK-38242:
---------------------------------
    Description: 
This ticket aims to improve the current upgrading documentation in two areas:

1. SQL/Table API State Compatibility Warning: The current compatibility guidelines do not clearly warn that SQL/Table API jobs can encounter state incompatibilities during minor version upgrades (e.g., 1.16 → 1.20) due to changes in query optimizers and operator topologies, giving the impression that the rules apply uniformly to all job types.

2. Missing Flink 2.x Versions: The compatibility table is missing Flink 2.0.x and 2.1.x versions.  

Changes needed:
 - Add clear warning about SQL/Table API state compatibility in the Compatibility Table section
 - Add Flink 2.0.x and 2.1.x rows to the compatibility table

  was:
This ticket aims to improve the current upgrading documentation in two areas:

1. **SQL/Table API State Compatibility Warning**: The current compatibility guidelines do not clearly warn that SQL/Table API jobs can encounter state incompatibilities during minor version upgrades (e.g., 1.16 → 1.20) due to changes in query optimizers and operator topologies, giving the impression that the rules apply uniformly to all job types.

2. **Missing Flink 2.x Versions**: The compatibility table is missing Flink 2.0.x and 2.1.x versions.  

Changes needed:
- Add clear warning about SQL/Table API state compatibility in the Compatibility Table section
- Add Flink 2.0.x and 2.1.x rows to the compatibility table


> Improve upgrading documentation for SQL/Table API state compatibility and add Flink 2.x to compatibility table
> --------------------------------------------------------------------------------------------------------------
>
>                 Key: FLINK-38242
>                 URL: https://issues.apache.org/jira/browse/FLINK-38242
>             Project: Flink
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Weiqing Yang
>            Priority: Major
>
> This ticket aims to improve the current upgrading documentation in two areas:
> 1. SQL/Table API State Compatibility Warning: The current compatibility guidelines do not clearly warn that SQL/Table API jobs can encounter state incompatibilities during minor version upgrades (e.g., 1.16 → 1.20) due to changes in query optimizers and operator topologies, giving the impression that the rules apply uniformly to all job types.
> 2. Missing Flink 2.x Versions: The compatibility table is missing Flink 2.0.x and 2.1.x versions.  
> Changes needed:
>  - Add clear warning about SQL/Table API state compatibility in the Compatibility Table section
>  - Add Flink 2.0.x and 2.1.x rows to the compatibility table



--
This message was sent by Atlassian Jira
(v8.20.10#820010)