Redis Stream
Redis Stream ist eine Datenstruktur, die in Redis Version 5.0 neu hinzugefügt wurde.
Redis Stream wird hauptsächlich für Nachrichtenwarteschlangen (MQ, Message Queue) verwendet. Redis selbst besitzt eine Redis-Publish/Subscribe-Funktion (Pub/Sub), um die Funktionalität von Nachrichtenwarteschlangen umzusetzen, aber sie hat einen Nachteil: Nachrichten können nicht dauerhaft gespeichert werden. Wenn es zu Netzwerkunterbrechungen, Redis-Ausfällen usw. kommt, werden Nachrichten verworfen.
Einfach gesagt: Publish/Subscribe (Pub/Sub) kann Nachrichten verteilen, aber es kann keine historischen Nachrichten aufzeichnen.
Redis Stream bietet Nachrichtenpersistenz und Master-Slave-Replikation, ermöglicht jedem Client jederzeit den Zugriff auf Daten, kann sich die Zugriffsposition jedes Clients merken und stellt sicher, dass Nachrichten nicht verloren gehen.
Die Struktur von Redis Stream ist unten dargestellt. Sie verfügt über eine verkettete Nachrichtenliste, die alle hinzugefügten Nachrichten miteinander verbindet. Jede Nachricht hat eine eindeutige ID und einen entsprechenden Inhalt:

Jeder Stream hat einen eindeutigen Namen, der der Redis-Schlüssel ist. Er wird automatisch erstellt, wenn wir zum ersten Mal den Befehl xadd verwenden, um eine Nachricht anzuhängen.
Erklärung des Diagramms:
- KonsumentengruppeKonsumentengruppe, erstellt mit dem Befehl XGROUP CREATE. Eine Konsumentengruppe hat mehrere Konsumenten.
- last_delivered_idCursor. Jede Konsumentengruppe hat einen Cursor, last_delivered_id. Wenn ein Konsument eine Nachricht liest, bewegt sich der Cursor last_delivered_id vorwärts.
- pending_idsZustandsvariable des Konsumenten, die verwendet wird, um die nicht bestätigten IDs des Konsumenten zu verwalten. pending_ids zeichnet Nachrichten auf, die vom Client bereits gelesen, aber noch nicht bestätigt (acked) wurden (Acknowledge character: Bestätigungszeichen).
Befehle im Zusammenhang mit Nachrichtenwarteschlangen:
- XADD- Fügt eine Nachricht am Ende hinzu
- XTRIM- Kürzt den Stream, um seine Länge zu begrenzen
- XDEL- Löscht eine Nachricht
- XLEN- Ruft die Anzahl der im Stream enthaltenen Elemente ab, d. h. die Nachrichtenlänge
- XRANGE- Ruft die Nachrichtenliste ab, die gelöschte Nachrichten automatisch herausfiltert
- XREVRANGE- Ruft die Nachrichtenliste in umgekehrter Reihenfolge ab, IDs vom größten zum kleinsten
- XREAD- Ruft die Nachrichtenliste im blockierenden oder nicht blockierenden Modus ab
Befehle im Zusammenhang mit Consumer-Gruppen:
- XGROUP CREATE- Erstellt eine Consumer-Gruppe
- XREADGROUP GROUP- Liest Nachrichten aus einer Consumer-Gruppe
- XACK- Markiert eine Nachricht als "verarbeitet"
- XGROUP SETID- Legt eine neue zuletzt zugestellte Nachrichten-ID für die Consumer-Gruppe fest
- XGROUP DELCONSUMER- Einen Consumer löschen
- XGROUP DESTROY- Eine Consumer-Gruppe löschen
- XPENDING- Informationen über ausstehende Nachrichten anzeigen
- XCLAIM- Eigentümerschaft einer Nachricht übertragen
- XINFO - Informationen über Streams und Consumer-Gruppen anzeigen;
- XINFO GROUPS- Consumer-Gruppen-Informationen ausgeben;
- XINFO STREAM- Stream-Informationen ausgeben
XADD
Verwenden Sie XADD, um eine Nachricht zur Warteschlange hinzuzufügen. Wenn die angegebene Warteschlange nicht existiert, wird eine Warteschlange erstellt. XADD-Syntaxformat:
XADD key ID field value [field value ...]
- keyWarteschlangenname; erstellen, falls nicht vorhanden
- IDNachrichten-ID. Wir verwenden *, um anzugeben, dass sie von Redis generiert wird. Sie kann angepasst werden, aber Sie müssen sicherstellen, dass sie inkrementell ist.
- FeldwertDatensatz.
Beispiel
"1601372323627-0"
redis> XADD mystream * field1 value1 field2 value2 field3 value3
"1601372323627-1"
redis> XLEN mystream
(integer) 2
redis> XRANGE mystream - +
1) 1) "1601372323627-0"
2) 1) "name"
2) "Sara"
3) "surname"
4) "OConnor"
2) 1) "1601372323627-1"
2) 1) "field1"
2) "value1"
3) "field2"
4) "value2"
5) "field3"
6) "value3"
redis>
XTRIM
Verwenden Sie XTRIM, um den Stream zu kürzen, um seine Länge zu begrenzen. Syntaxformat:
XTRIM key MAXLEN [~] count
- keyWarteschlangenname
- MAXLENLänge
- countAnzahl
Beispiel
"1601372434568-0"
127.0.0.1:6379> XTRIM mystream MAXLEN 2
(integer) 0
127.0.0.1:6379> XRANGE mystream - +
1) 1) "1601372434568-0"
2) 1) "field1"
2) "A"
3) "field2"
4) "B"
5) "field3"
6) "C"
7) "field4"
8) "D"
127.0.0.1:6379>
redis>
XDEL
Verwenden Sie XDEL, um Nachrichten zu löschen. Syntaxformat:
XDEL key ID [ID ...]
- keyWarteschlangenname
- IDNachrichten-ID
Beispiel
1538561698944-0
> XADD mystream * b 2
1538561700640-0
> XADD mystream * c 3
1538561701744-0
> XDEL mystream 1538561700640-0
(integer) 1
127.0.0.1:6379> XRANGE mystream - +
1) 1) 1538561698944-0
2) 1) "a"
2) "1"
2) 1) 1538561701744-0
2) 1) "c"
2) "3"
XLEN
Verwenden Sie XLEN, um die Anzahl der im Stream enthaltenen Elemente zu erhalten, d. h. die Nachrichtenlänge. Syntaxformat:
XLEN key
- keyWarteschlangenname
Beispiel
"1601372563177-0"
redis> XADD mystream * item 2
"1601372563178-0"
redis> XADD mystream * item 3
"1601372563178-1"
redis> XLEN mystream
(integer) 3
redis>
XRANGE
Verwenden Sie XRANGE, um die Nachrichtenliste abzurufen, die automatisch gelöschte Nachrichten herausfiltert. Syntaxformat:
XRANGE key start end [COUNT count]
- keyWarteschlangenname
- startStartwert,-stellt den Minimalwert dar
- endEndwert,+stellt den Maximalwert dar
- countAnzahl
Beispiel
"1601372577811-0"
redis> XADD writers * name Jane surname Austen
"1601372577811-1"
redis> XADD writers * name Toni Morrison
"1601372577811-2"
redis> XADD writers * name Agatha Christie
"1601372577812-0"
redis> XADD writers * name Ngozi Adichie
"1601372577812-1"
redis> XLEN writers
(integer) 5
redis> XRANGE writers - + COUNT 2
1) 1) "1601372577811-0"
2) 1) "name"
2) "Virginia"
3) "surname"
4) "Woolf"
2) 1) "1601372577811-1"
2) 1) "name"
2) "Jane"
3) "surname"
4) "Austen"
redis>
XREVRANGE
Verwenden Sie XREVRANGE, um die Nachrichtenliste abzurufen, die gelöschte Nachrichten automatisch herausfiltert. Syntaxformat:
XREVRANGE key end start [COUNT count]
- keyWarteschlangenname
- endEndwert,+stellt den Maximalwert dar
- startStartwert,-stellt den Minimalwert dar
- countAnzahl
Beispiel
"1601372731458-0"
redis> XADD writers * name Jane surname Austen
"1601372731459-0"
redis> XADD writers * name Toni Morrison
"1601372731459-1"
redis> XADD writers * name Agatha Christie
"1601372731459-2"
redis> XADD writers * name Ngozi Adichie
"1601372731459-3"
redis> XLEN writers
(integer) 5
redis> XREVRANGE writers + - COUNT 1
1) 1) "1601372731459-3"
2) 1) "name"
2) "Ngozi"
3) "surname"
4) "Adichie"
redis>
XREAD
Verwenden Sie XREAD, um die Nachrichtenliste im blockierenden oder nicht blockierenden Modus abzurufen. Syntaxformat:
XREAD [COUNT count] [BLOCK milliseconds] STREAMS key [key ...] id [id ...]
- countAnzahl
- millisecondsOptional. Blockierende Millisekunden. Wenn nicht gesetzt, ist es der nicht blockierende Modus.
- keyWarteschlangenname
- idNachrichten-ID
Beispiel
> XREAD COUNT 2 STREAMS mystream writers 0-0 0-0
1) 1) "mystream"
2) 1) 1) 1526984818136-0
2) 1) "duration"
2) "1532"
3) "event-id"
4) "5"
5) "user-id"
6) "7782813"
2) 1) 1526999352406-0
2) 1) "duration"
2) "812"
3) "event-id"
4) "9"
5) "user-id"
6) "388234"
2) 1) "writers"
2) 1) 1) 1526985676425-0
2) 1) "name"
2) "Virginia"
3) "surname"
4) "Woolf"
2) 1) 1526985685298-0
2) 1) "name"
2) "Jane"
3) "surname"
4) "Austen"
XGROUP CREATE
Verwenden Sie XGROUP CREATE, um eine Consumer-Gruppe zu erstellen. Syntaxformat:
XGROUP [CREATE key groupname id-or-$] [SETID key groupname id-or-$] [DESTROY key groupname] [DELCONSUMER key groupname consumername]
- keyWarteschlangenname; erstellen, falls nicht vorhanden
- groupnameGruppenname.
- $Gibt an, dass vom Ende konsumiert wird, wobei nur neue Nachrichten akzeptiert werden. Alle aktuellen Stream-Nachrichten werden ignoriert.
Beginnen Sie mit dem Konsumieren vom Anfang:
XGROUP CREATE mystream consumer-group-name 0-0
Beginnen Sie mit dem Konsumieren vom Ende:
XGROUP CREATE mystream consumer-group-name $
XREADGROUP GROUP
Verwenden Sie XREADGROUP GROUP, um Nachrichten aus einer Consumer-Gruppe zu lesen. Syntaxformat:
XREADGROUP GROUP group consumer [COUNT count] [BLOCK milliseconds] [NOACK] STREAMS key [key ...] ID [ID ...]
- groupConsumer-Gruppenname
- consumerConsumer-Name.
- countAnzahl zu lesender Nachrichten.
- millisecondsBlockierende Millisekunden.
- keyName der Warteschlange.
- IDNachrichten-ID.
XREADGROUP GROUP consumer-group-name consumer-name COUNT 1 STREAMS mystream >Weitere Erweiterungen