Redis 与缓存 / 系统课时

认识 Stream 消息结构

认识 Stream 消息结构

本课解决“Redis Stream 中一条消息由哪些部分组成”的问题。完成后,你可以识别流键、消息 ID、字段和值,并理解 Stream 适合保存按时间追加的事件记录。

学习目标

  • 识别 Stream 的层级结构
  • 理解消息 ID 的组成和顺序
  • 区分 Stream 与简单 List 队列

Stream 的结构

一个 Stream 键代表一条消息流。流中每条 Entry 都有唯一 ID,并携带一个或多个字段和值;不同消息可以使用不同字段,但生产系统通常应保持统一格式。

Redis Stream 消息结构图

消息 ID 形如 1710000000000-0。左侧通常是毫秒时间戳,右侧是同一毫秒内的序号。使用 * 时由 Redis 生成递增 ID;手工指定的新 ID 必须大于流中当前最大 ID。

追加并查看消息

为便于得到稳定输出,下面显式使用 ID 1-0。生产代码通常传入 *,并保存 XADD 返回的实际 ID。

bash
redis-cli DEL demo:stream:orders:0807 >/dev/null

echo "xadd:"
redis-cli --raw XADD demo:stream:orders:0807 1-0 orderId 1001 status CREATED amount 99.00

echo "range:"
redis-cli --raw XRANGE demo:stream:orders:0807 - +

echo "length:"
redis-cli --raw XLEN demo:stream:orders:0807

预期输出:

text
xadd:
1-0
range:
1-0
orderId
1001
status
CREATED
amount
99.00
length:
1

- 和 + 分别表示最小与最大 ID。字段和值都按字符串保存,数值类型、状态含义和必填字段由应用协议解释。

与 List 的区别

List 适合简单先进先出队列;Stream 还提供稳定消息 ID、范围查询、阻塞读取、消费者组和待确认列表。读取 Stream 不会自动删除消息,历史保留需要单独配置裁剪策略。

Stream 也不是完整消息队列的自动替代品。生产系统仍要设计消息幂等、失败重试、容量裁剪、持久化和故障恢复策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

认识 Stream 消息结构

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

登录哪都通