Skip to content

Update streams.md with XREADGROUP behavior details #2553

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dwdougherty merged 5 commits into from
Dec 17, 2025
Merged

Update streams.md with XREADGROUP behavior details #2553

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
0a81398
Update streams.md with XREADGROUP behavior details
LiorKogan Dec 17, 2025
cb58711
Clarify XREADGROUP message order guarantees
LiorKogan Dec 17, 2025
1ec37a5
Update XREADGROUP message ordering explanation
LiorKogan Dec 17, 2025
242f53b
Update order guarantees for Active-Active streams
LiorKogan Dec 17, 2025
487ae3f
Apply suggestions from code review
dwdougherty Dec 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions content/operate/rs/databases/active-active/develop/data-types/streams.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -297,8 +297,12 @@ This means that the XREADGROUP does not return already-acknowledged entries.
### Guarantees

Unlike XREAD, XREADGOUP will never skip stream entries.

In traffic redirection, XREADGROUP may return entries that have been read but not acknowledged. It may also even return entries that have already been acknowledged.

When entries are added from multiple regions, Redis guarantees ordered entries in the reply of a single read command (`XREAD`, `XREADGROUP`, or `XRANGE`). However, ordered IDs are not guaranteed for a sequence of read commands.
For example, two subsequent `XREADGROUP GROUP group consumer COUNT 1 STREAMS key >` commands may reply with decreasing IDs.

## Summary

With Active-Active streams, you can write to the same logical stream from multiple regions. As a result, the behavior of Active-Active streams differs somewhat from the behavior you get with Redis Open Source. This is summarized below:
Expand Down