Redis 与缓存 / 系统课时

使用 XADD 写入消息

使用 XADD 写入消息

本课解决如何把业务事件写入 Redis Stream,并在追加消息时控制保留长度。完成后,你可以用 XADD 创建 Stream、写入字段数据,并正确区分精确裁剪与 ~ 近似裁剪的长度语义。

学习目标

  • 掌握 XADD 的自动 ID、字段和值写法。
  • 理解 MAXLEN 精确裁剪与 ~ 近似裁剪的差异。
  • 能用 XLEN 和 XRANGE 验证写入与裁剪结果。

用 XADD 创建并追加消息

XADD 会向指定 Stream 追加一条消息;目标 Stream 不存在时会自动创建。通常让 Redis 用 * 生成消息 ID,再写入一个或多个字段和值。在 Shell 中应给 * 加引号,避免它被文件名通配展开。

下面用一个连续示例完成创建、追加、精确裁剪和结果验证:

bash
redis-cli DEL orders >/dev/null
redis-cli XADD orders '*' order_id 1001 status paid
redis-cli XADD orders '*' order_id 1002 status shipped
redis-cli XADD orders '*' order_id 1003 status created
redis-cli XADD orders MAXLEN 3 '*' order_id 1004 status packed
redis-cli XLEN orders
redis-cli XRANGE orders - +

预期结果

text
<generated-id-1>
<generated-id-2>
<generated-id-3>
<generated-id-4>
(integer) 3
1) 1) "<generated-id-2>"
   2) 1) "order_id"
      2) "1002"
      3) "status"
      4) "shipped"
2) 1) "<generated-id-3>"
   2) 1) "order_id"
      2) "1003"
      3) "status"
      4) "created"
3) 1) "<generated-id-4>"
   2) 1) "order_id"
      2) "1004"
      3) "status"
      4) "packed"

实际 ID 通常形如 1750000000000-0,会随执行时间变化。MAXLEN 3 使用精确裁剪,因此第四条消息加入后,最早的消息被删除,XLEN 可以严格验证当前长度为 3。

理解近似裁剪的长度语义

持续写入的 Stream 往往更适合 MAXLEN ~ N。~ 允许 Redis 按内部存储节点进行近似裁剪,避免为了每次都严格达到 N 条而处理边界,因此通常能降低持续写入时的裁剪开销,但当前实际长度可能高于目标值。

下面写入足够多的消息,再用 XLEN 观察实际长度。在 Shell 中同样给 ~ 加引号,避免它被解释为用户主目录:

bash
redis-cli DEL orders-approx >/dev/null
for i in $(seq 1 120); do
  redis-cli XADD orders-approx MAXLEN '~' 10 '*' seq "$i" >/dev/null
done
redis-cli XLEN orders-approx

预期结果

text
(integer) <VALUE>

<VALUE> 是执行完成时 Stream 的真实条目数,受 Redis 版本、配置以及 Stream 内部节点组织方式影响,不保证等于 10,也可能明显大于 10。这里用 XLEN 的目的不是证明近似裁剪达到了目标值,而是验证“目标长度”和“实际长度”可以不同:只要写入命令成功且 XLEN 返回当前长度,观察到大于 10 的结果并不表示裁剪失效,而是近似裁剪语义的正常表现。若业务要求长度绝不能超过 10,应改用 MAXLEN 10 的精确裁剪。

ID 与保留策略怎么选

消息 ID 默认交给 Redis 生成通常最稳妥。业务编号应放在 order_id、event_id 等消息字段中,而不是直接充当 Stream ID;Stream ID 主要承担排序、定位和读取游标的职责。

MAXLEN 也不是按时间过期的策略,它根据消息数量裁剪,而不是根据消息年龄删除数据。如果要求“保留最近 24 小时”,不能仅用 MAXLEN 表达,应另外设计基于时间边界的清理策略。

生产环境应先明确 Stream 的容量和保留要求:需要严格条数上限时使用精确裁剪;允许短暂超出目标、希望降低持续写入成本时使用近似裁剪,并用 XLEN 观察当前实际长度。

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

目录与阅读设置

记录一个想法

使用 XADD 写入消息

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

登录哪都通