raminqaf opened a new pull request, #28166:
URL: https://github.com/apache/flink/pull/28166

   ## What is the purpose of the change
   
   CDC streams often deliver events out of order. The PTF ORDER BY clause 
introduced in FLINK-39256 aligns naturally with FROM_CHANGELOG: partitioning by 
the primary key and ordering by event time reorders out-of-order CDC events per 
key before the operations are applied.
   
   Adds a new "Ordering CDC events with ORDER BY" subsection to the 
FROM_CHANGELOG documentation with the SQL example and the requirements 
(watermarked time attribute, ASC on the first order column, set semantics via 
PARTITION BY). Extends the Table API examples with the equivalent 
partitionBy(...).orderBy(...).fromChangelog() pattern.
   
   Adds a corresponding example in the PartitionedTable#fromChangelog Javadoc.
   
   Adds a cross-reference from the PTF ORDER BY guide to FROM_CHANGELOG so 
users discover the pattern from either side.
   
   ## Does this pull request potentially affect one of the following parts:
   
     - Dependencies (does it add or upgrade a dependency): (no)
     - The public API, i.e., is any changed class annotated with 
`@Public(Evolving)`: (no)
     - The serializers: (no)
     - The runtime per-record code paths (performance sensitive): (no)
     - Anything that affects deployment or recovery: JobManager (and its 
components), Checkpointing, Kubernetes/Yarn, ZooKeeper: (no)
     - The S3 file system connector: (no)
   
   ## Documentation
   
     - Does this pull request introduce a new feature? (no)
     - If yes, how is the feature documented? (docs / JavaDocs)
   
   ---
   
   ##### Was generative AI tooling used to co-author this PR?
   
   <!--
   If generative AI tooling has been used in the process of authoring this PR, 
please
   change the checkbox below to `[X]` followed by the name of the tool, and 
uncomment the
   "Generated-by" line. See the ASF Generative Tooling Guidance for details:
   https://www.apache.org/legal/generative-tooling.html
   
   You are responsible for the quality and correctness of every change in this 
PR
   regardless of the tooling used. Low-effort AI-generated PRs will be closed. 
See
   AGENTS.md for the full guidance.
   -->
   
   - [X] Yes (please specify the tool below)
   
   Generated-by: Opus 4.7
   


-- 
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