Redis 与缓存 / 系统课时
写入与读取 Stream
写入与读取 Stream
本课解决如何向 Stream 追加消息,以及如何读取历史消息和后续新增消息。完成后,你可以使用 XADD 写入条目、用 XRANGE 按 ID 查询范围,并让 XREAD 从已处理位置继续读取。
学习目标
- 使用
XADD追加带字段的消息 - 使用
XRANGE查询指定 ID 范围 - 使用
XREAD增量读取或阻塞等待新消息
写入消息
Stream 中的每条消息都有唯一 ID,格式为“毫秒时间戳-序号”。下面使用固定 ID,便于重复观察读取边界;生产环境通常让 Redis 自动生成 ID。
bash
DEL stream:events
XADD stream:events 1-0 type LOGIN userId 101
XADD stream:events 2-0 type PAY userId 101 amount 88.00
XLEN stream:events预期输出:
text
(integer) <DELETED_KEY_COUNT>
"1-0"
"2-0"
(integer) 2<DELETED_KEY_COUNT> 取决于执行前键是否存在。生产写入可将 ID 改为 *,Redis 会返回实际生成的 <MESSAGE_ID>;客户端应保存这个返回值,而不是自行猜测。
查询历史范围
XRANGE key start end 按 ID 从小到大读取闭区间,COUNT 用于限制本次返回数量。
bash
XRANGE stream:events 1-0 2-0 COUNT 10预期输出:
text
1) 1) "1-0"
2) 1) "type"
2) "LOGIN"
3) "userId"
4) "101"
2) 1) "2-0"
2) 1) "type"
2) "PAY"
3) "userId"
4) "101"
5) "amount"
6) "88.00"边界前加左括号可排除该 ID,例如 (1-0 表示严格大于 1-0。需要从大到小读取时使用 XREVRANGE。
从游标继续读取
XREAD 返回严格大于起始 ID 的消息,因此读取端应在业务处理成功后保存最后一个消息 ID。
bash
XREAD COUNT 10 STREAMS stream:events 1-0预期输出:
text
1) 1) "stream:events"
2) 1) 1) "2-0"
2) 1) "type"
2) "PAY"
3) "userId"
4) "101"
5) "amount"
6) "88.00"首次等待新消息时可使用 XREAD BLOCK 5000 STREAMS stream:events $。$ 只表示命令执行时的流尾,后续读取必须改用上次返回的 ID,否则可能漏掉两次调用之间到达的消息。5 秒内没有新增时,命令返回 nil。
高频 Stream 可在 XADD 中使用 MAXLEN ~ <COUNT> 做近似裁剪,但裁剪会删除旧条目,应先确认业务不再需要这些历史消息。
按自己的节奏,确认真正理解。