gustavodemorais commented on code in PR #28123:
URL: https://github.com/apache/flink/pull/28123#discussion_r3258444559


##########
docs/content/release-notes/flink-2.3.md:
##########
@@ -27,19 +27,282 @@ These release notes discuss important aspects, such as 
configuration, behavior o
 that changed between Flink 2.2 and Flink 2.3. Please read these notes 
carefully if you are
 planning to upgrade your Flink version to 2.3.
 
+### Table SQL / API
 
-### Core
+#### FROM_CHANGELOG and TO_CHANGELOG built-in PTFs
 
-#### Set security.ssl.algorithms default value to modern cipher suite
+##### [FLINK-39258](https://issues.apache.org/jira/browse/FLINK-39258) 
(FLIP-564)
 
-### [FLINK-39022](https://issues.apache.org/jira/browse/FLINK-39022)
+The DataStream API has long offered `toChangelogStream()` and 
`fromChangelogStream()` for working
+with changelog streams; Flink 2.3 brings equivalent functionality to SQL via 
two new built-in
+Process Table Functions:
 
-A JDK update (affecting JDK 11.0.30+, 17.0.18+, 21.0.10+, and 24+) disabled 
`TLS_RSA_*` cipher suites.
-This was done to support forward-secrecy (RFC 9325) and comply with the IETF 
Draft on *Deprecating Obsolete Key Exchange Methods in TLS*.
+- `FROM_CHANGELOG` converts an append-only stream that carries an operation 
column (and optional
+  before/after row descriptors) into a dynamic table. A configurable 
`op_mapping` makes it
+  straightforward to plug in custom CDC formats (e.g. Debezium-style 
`c`/`u`/`d` codes), and
+  `invalid_op_handling` (`FAIL`/`LOG`/`SKIP`) controls how rows with unmapped 
operation codes
+  are treated.
+- `TO_CHANGELOG` is the inverse: it materializes a dynamic table back into an 
append-only
+  changelog stream. This is the first SQL-level operator that lets users 
convert
+  retract/upsert streams into append form, which is useful for archival, audit 
and writing to
+  append-only sinks. `produces_full_deletes` controls whether `-D` records 
carry the full row.
 
-To support these and future JDK versions, the default value for the Flink 
configuration option `security.ssl.algorithms` has been changed to a modern, 
widely available cipher suite:
+The two PTFs are designed to be symmetric, so 
`FROM_CHANGELOG(TO_CHANGELOG(table))` round-trips
+correctly. Both support `PARTITION BY` for parallel execution and `uid` for 
query evolution, and
+they expose a `state_ttl` parameter for state retention.

Review Comment:
   I've drafted the updated notes, take a look @raminqaf and @twalthr 
   
   > - `FROM_CHANGELOG` converts an append-only stream that carries an 
operation column into a dynamic table. A configurable `op_mapping` makes it 
straightforward to plug in custom CDC formats and controls how rows with 
unmapped operation codes are treated.
   > - `TO_CHANGELOG` is the inverse: it materializes a dynamic table back into 
an append-only changelog stream. This is the first SQL-level operator that lets 
users convert retract or upsert streams into append form — useful for archival, 
audit, writing to append-only sinks, and working around pipelines that require 
an append-only table.
   > 
   > The 2.3 release covers limited basic use cases for both. Future versions 
will extend both functions with `PARTITION BY`, `invalid_op_handling`, 
`produces_full_deletes` and more to make both features powerful and extensive. 
See 
[FLIP-564](https://cwiki.apache.org/confluence/display/FLINK/FLIP-564%3A+Support+FROM_CHANGELOG+and+TO_CHANGELOG+built-in+PTFs).
   
   Markdown:
   ```
   - `FROM_CHANGELOG` converts an append-only stream that carries an operation 
column into a dynamic table. A configurable `op_mapping` makes it 
straightforward to plug in custom CDC formats and controls how rows with 
unmapped operation codes are treated.
   - `TO_CHANGELOG` is the inverse: it materializes a dynamic table back into 
an append-only changelog stream. This is the first SQL-level operator that lets 
users convert retract or upsert streams into append form — useful for archival, 
audit, writing to append-only sinks, and working around pipelines that require 
an append-only table.
   
   The 2.3 release covers limited basic use cases for both. Future versions 
will extend both functions with `PARTITION BY`, `invalid_op_handling`, 
`produces_full_deletes` and more to make both features powerful and extensive. 
See 
[FLIP-564](https://cwiki.apache.org/confluence/display/FLINK/FLIP-564%3A+Support+FROM_CHANGELOG+and+TO_CHANGELOG+built-in+PTFs).
   ```
   



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to