*Redis XADD 命令 向 Stream 追加消息

*语法

XADD key [NOMKSTREAM] [MAXLEN | MINID [= | ~] threshold [LIMIT count]] *|ID field value [field value ...]

*说明

向 Stream 添加消息。

选项：

  • NOMKSTREAM：如果 key 不存在，不创建新 Stream
  • MAXLEN：限制 Stream 最大长度（近似或精确）
  • MINID：限制 Stream 最小 ID
  • *：自动生成 ID（基于时间戳）

*返回值

  • 字符串：消息的 ID

*时间复杂度

  • O(1)

*版本兼容性

Redis 版本 说明
>= 5.0.0 可用
>= 6.2.0 支持 MINID 和 LIMIT

*示例

# 基本添加
redis-cli XADD mystream * name Alice age 30

# 限制 Stream 长度
redis-cli XADD mystream MAXLEN 1000 * name Bob age 25

# 近似限制（更高效）
redis-cli XADD mystream MAXLEN ~ 1000 * name Charlie age 35