THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Status
...
| Page properties | |
|---|---|
|
...
|
JIRA: here (<- TBD)
...
Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).
...
Most information about API compatibility could find on the internet suggested by google are about RESTful API which means a client (a program written to consume the API) that can work with one version of the API can work the same way with future versions of the API [6]. FLIP-196 makes it clear with the focus of Flink or programmatic API: a program written against a public API will compile w/o errors when upgrading Flink [4]. Based on the information given by FLIP-196, Flink provides API backward compatibility except some corner cases with the RESTful API. IMHO, this is great but does not fulfill users requirements, because users want their Flink jobs to be running without errors, not just compile them, which turns out that what users actually required is the ABI compatibility [7], e.g. connectors build with Flink 1.13 want to be running on Flink 1.12 Cluster with no issue. That is why I mentioned at the beginning that the original request in the API compatibility thread [1] was actually asking for Flink ABI forward compatibility, which Flink didn't provide.
...
The lastChange field show the API stability and could provide hint for the API to be graduated. Depending on the graduation rule, we will have a clear picture of the current status of all @PublicEvolving interface. For example, if the rule is to graduate a @PublicEvolving interface after two unchanged versions
| Class | backwardCompatible | lastChange | last_release | Status |
|---|---|---|---|---|
| Foo | FlinkVersion.V1_12_0 | FlinkVersion.V1_13_0 | FlinkVersion.V1_15_0 | go public for 1.16 release |
| Bar | FlinkVersion.V1_13_0 | FlinkVersion.V1_13_0 | go public for 1.16 release | |
| Baz | FlinkVersion.V1_12_0 | FlinkVersion.V1_14_0 | mature | |
| Qux | FlinkVersion.V1_12_0 | FlinkVersion.V1_15_0 | under development | |
| Quux | FlinkVersion.V1_15_0 | FlinkVersion.V1_15_0 | unstable | |
| Corge | FlinkVersion.V1_12_0 | FlinkVersion.V1_12_0 | Warning, there must be some specific issue to postpone the graduation |
If we want fine-grained control, we could also consider adding them at method level.
...