Skip to content

Commit 0e7e9a8

Browse files
committed
Mention super streams do not deprecate streams
In documentation.
1 parent 04d8203 commit 0e7e9a8

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

src/docs/asciidoc/super-streams.adoc

+11
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,17 @@ Consuming applications can use super streams and <<api.adoc#single-active-consum
1515
The 2 features combined make sure only one consumer instance consumes from an individual stream at a time.
1616
In this configuration, super streams provide scalability and single active consumer provides the guarantee that messages of an individual stream are processed in order.
1717

18+
[WARNING]
19+
.Super streams do not deprecate streams
20+
====
21+
Super streams are a https://en.wikipedia.org/wiki/Partition_(database)[partitioning] solution.
22+
They are not meant to replace individual streams, they sit on top of them to handle some use cases in a better way.
23+
If the stream data is likely to be large – hundreds of gigabytes or even terabytes, size remains relative – and even presents an obvious partition key (e.g. country), a super stream can be appropriate.
24+
It can help to cope with the data size and to take advantage of data locality for some processing use cases.
25+
Remember that partitioning always comes with complexity though, even if the implementation of super streams strives to make it as transparent as possible for the application developer.
26+
====
27+
28+
1829
===== Topology
1930

2031
A super stream is made of several individual streams, so it can be considered a logical entity rather than an actual physical entity.

0 commit comments

Comments
 (0)