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> 做近似裁剪,但裁剪会删除旧条目,应先确认业务不再需要这些历史消息。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

写入与读取 Stream

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通