(kafka) branch 3.7 updated: KAFKA-12317: Update FK-left-join documentation (#15689)

[mjsax]

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

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


The following commit(s) were added to refs/heads/3.7 by this push:
     new c979ef2f7d0 KAFKA-12317: Update FK-left-join documentation (#15689)
c979ef2f7d0 is described below

commit c979ef2f7d0bcce0d2f5a80dffbb42ddbb84ed62
Author: Florin Akermann <florin.akerm...@gmail.com>
AuthorDate: Thu Jun 6 00:22:31 2024 +0200

    KAFKA-12317: Update FK-left-join documentation (#15689)
    
    FK left-join was changed via KIP-962. This PR updates the docs accordingly.
    
    Reviewers: Ayoub Omari <ayouboma...@outlook.fr>, Matthias J. Sax 
<matth...@confluent.io>
---
 docs/streams/developer-guide/dsl-api.html | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/streams/developer-guide/dsl-api.html 
b/docs/streams/developer-guide/dsl-api.html
index acd40ad835f..fd5c22cae33 100644
--- a/docs/streams/developer-guide/dsl-api.html
+++ b/docs/streams/developer-guide/dsl-api.html
@@ -2542,6 +2542,10 @@ Function&lt;Long, Long&gt; foreignKeyExtractor = (x) 
-&gt; x;
                                   <blockquote>
                                     <div>
                                       <ul class="simple">
+                                        <li>
+                                            Records for which the <code 
class="docutils literal"><span class="pre">foreignKeyExtractor</span></code> 
produces <code class="docutils literal"><span class="pre">null</span></code> 
are ignored and do not trigger a join.
+                                            If you want to join with <code 
class="docutils literal"><span class="pre">null</span></code> foreign keys, use 
a suitable sentinel value to do so (i.e. <code class="docutils literal"><span 
class="pre">"NULL"</span></code> for a String field, or <code class="docutils 
literal"><span class="pre">-1</span></code> for an auto-incrementing integer 
field).
+                                        </li>
                                         <li>Input records with a <code 
class="docutils
                                             literal"><span 
class="pre">null</span></code>
                                           value are interpreted as 
<em>tombstones</em>
@@ -2601,10 +2605,6 @@ Function&lt;Long, Long&gt; foreignKeyExtractor = (x) 
-&gt; x;
                                   <blockquote>
                                     <div>
                                       <ul class="simple">
-                                        <li>
-                                            Records for which the <code 
class="docutils literal"><span class="pre">foreignKeyExtractor</span></code> 
produces <code class="docutils literal"><span class="pre">null</span></code> 
are ignored and do not trigger a join.
-                                            If you want to join with <code 
class="docutils literal"><span class="pre">null</span></code> foreign keys, use 
a suitable sentinel value to do so (i.e. <code class="docutils literal"><span 
class="pre">"NULL"</span></code> for a String field, or <code class="docutils 
literal"><span class="pre">-1</span></code> for an auto-incrementing integer 
field).
-                                        </li>
                                         <li>Input records with a <code 
class="docutils
                                             literal"><span 
class="pre">null</span></code>
                                           value are interpreted as 
<em>tombstones</em>