mjsax commented on code in PR #18258:
URL: https://github.com/apache/kafka/pull/18258#discussion_r1984233834
##########
docs/streams/upgrade-guide.html:
##########
@@ -1735,73 +1735,38 @@ <h3 class="anchor-heading"><a
id="streams_api_changes_0101" class="anchor-link">
<h3 class="anchor-heading"><a id="streams_api_broker_compat"
class="anchor-link"></a><a href="#streams_api_broker_compat">Streams API broker
compatibility</a></h3>
- <p>The following table shows which versions of the Kafka Streams API are
compatible with various Kafka broker versions.</p>
+ <p>The following table shows which versions of the Kafka Streams API are
compatible with various Kafka broker versions. For Kafka Stream version older
than 2.3.x, please check <a href="/39/documentation/streams/upgrade-guide">3.9
upgrade document</a>.</p>
<table border="1" class="non-scrolling-table docutils">
<thead>
<tr>
<th></th>
- <th colspan="5">Kafka Broker (columns)</th>
+ <th colspan="2">Kafka Broker (columns)</th>
</tr>
</thead>
<tbody>
<tr>
<td>Kafka Streams API (rows)</td>
- <td>0.10.0.x</td>
- <td>0.10.1.x and 0.10.2.x</td>
- <td>0.11.0.x and<br>1.0.x and<br>1.1.x and<br>2.0.x</td>
<td>2.1.x and<br>2.2.x and<br>2.3.x and<br>2.4.x and<br>2.5.x
and<br>2.6.x and<br>2.7.x and<br>2.8.x and<br>3.0.x and<br>3.1.x and<br>3.2.x
and<br>3.3.x and<br>3.4.x and<br>3.5.x and<br>3.6.x and<br>3.7.x and<br>3.8.x
and<br>3.9.x</td>
<td>4.0.x</td>
</tr>
<tr>
- <td>0.10.0.x</td>
+ <td>2.4.x and<br>2.5.x</td>
+ <td>compatible with exactly-once v2 turned off</td>
<td>compatible</td>
- <td>compatible</td>
- <td>compatible</td>
- <td>compatible</td>
- <td></td>
</tr>
<tr>
- <td>0.10.1.x and 0.10.2.x</td>
- <td></td>
- <td>compatible</td>
- <td>compatible</td>
- <td>compatible</td>
- <td></td>
- </tr>
- <tr>
- <td>0.11.0.x</td>
- <td></td>
- <td>compatible with exactly-once turned off<br>(requires broker
version 0.11.0.x or higher)</td>
- <td>compatible</td>
- <td></td>
- </tr>
- <tr>
- <td>1.0.x and<br>1.1.x and<br>2.0.x and<br>2.1.x and<br>2.2.0
and<br>2.2.0</td>
- <td></td>
- <td>compatible with exactly-once turned off<br>(requires broker
version 0.11.0.x or higher);<br>requires message format 0.10 or
higher;<br>message headers are not supported<br>(requires broker version
0.11.0.x or higher<br>with message format 0.11 or higher)</td>
- <td>compatible; requires message format 0.10 or higher;<br>if
message headers are used, message format 0.11<br>or higher required</td>
- <td>compatible</td>
- <td></td>
- </tr>
- <tr>
- <td>2.2.1 and<br>2.3.x and<br>2.4.x and<br>2.5.x and<br>2.6.x
and<br>2.7.x and<br>2.8.x and<br>3.0.x and<br>3.1.x and<br>3.2.x and<br>3.3.x
and<br>3.4.x and<br>3.5.x and<br>3.6.x and<br>3.7.x and<br>3.8.x
and<br>3.9.x</td>
- <td></td>
- <td></td>
- <td>compatible; requires message format 0.11 or
higher;<br>enabling exactly-once v2 requires 2.5.x or higher</td>
+ <td>2.6.x and<br>2.7.x and<br>2.8.x and<br>3.0.x and<br>3.1.x
and<br>3.2.x and<br>3.3.x and<br>3.4.x and<br>3.5.x and<br>3.6.x and<br>3.7.x
and<br>3.8.x and<br>3.9.x</td>
+ <td>compatible; enabling exactly-once v2 requires broker version
2.5.x or higher</td>
<td>compatible</td>
- <td></td>
</tr>
<tr>
<td>4.0.x</td>
- <td></td>
- <td></td>
- <td></td>
- <td>compatible; enabling exactly-once v2 requires broker version
2.5.x or higher</td>
+ <td>compatible</td>
Review Comment:
Given that KS 4.0.x does not include EOSv1 any longer, we should also call
this out? KS 4.0 with EOSv2 does require broker 2.5+ too.
Given that we don't have EOSv1 in KS 4.0 any longer, we could say "enabling
exactly-once requires broker version 2.5.x or higher" (ie, drop the `v2` thing).
Or: we just merge 4.0 row with `2.6.x - 3.9.x` row?
--
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: jira-unsubscr...@kafka.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
