[kafka-site] branch asf-site updated: MINOR: add KIP-941 to Kafka Streams upgrade docs (#563)

[mj...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

mjsax pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/kafka-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 6ea1a698 MINOR: add KIP-941 to Kafka Streams upgrade docs (#563)
6ea1a698 is described below

commit 6ea1a69858618b997b4d3916f24a38b2ac717520
Author: Matthias J. Sax <ma...@confluent.io>
AuthorDate: Wed Oct 18 17:26:07 2023 -0700

    MINOR: add KIP-941 to Kafka Streams upgrade docs (#563)
    
    Porting https://github.com/apache/kafka/pull/14577
---
 36/streams/upgrade-guide.html | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/36/streams/upgrade-guide.html b/36/streams/upgrade-guide.html
index 22dada21..6d75d724 100644
--- a/36/streams/upgrade-guide.html
+++ b/36/streams/upgrade-guide.html
@@ -140,6 +140,13 @@
       For more information, including how it can be enabled and further configured, see the <a href="/{{version}}/documentation/streams/developer-guide/config-streams.html#rack-aware-assignment-strategy"><b>Kafka Streams Developer Guide</b></a>.
     </p>
 
+    <p>
+      IQv2 supports a <code>RangeQuery</code> that allows to specify unbounded, bounded, or half-open key-ranges. Users have to use <code>withUpperBound(K)</code>, <code>withLowerBound(K)</code>,
+      or <code>withNoBounds()</code> to specify half-open or unbounded ranges, but cannot use <code>withRange(K lower, K upper)</code> for the same.
+      <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-941%3A+Range+queries+to+accept+null+lower+and+upper+bounds">KIP-941</a> closes this gap by allowing to pass in <code>null</code>
+      as upper and lower bound (with semantics "no bound") to simplify the usage of the <code>RangeQuery</code> class.
+    </p>
+
     <h3><a id="streams_api_changes_350" href="#streams_api_changes_350">Streams API changes in 3.5.0</a></h3>
     <p>      
       A new state store type, versioned key-value stores, was introduced in