设置组 ID
语法
XGROUP SETID key group <id | $> [ENTRIESREAD entries-read]
- 可用版本
- 5.0.0
- 时间复杂度
- O(1)
- ACL 类别
-
@write
,@stream
,@slow
,
设置消费者组的 **最后传递 ID**。
通常,消费者组的最后传递 ID 是在使用 XGROUP CREATE
创建组时设置的。XGROUP SETID
命令允许修改组的最后传递 ID,而无需删除和重新创建组。例如,如果您希望消费者组中的消费者重新处理流中的所有消息,您可能希望将其下一个 ID 设置为 0
XGROUP SETID mystream mygroup 0
可选的 entries_read
参数可以指定,以启用消费者组延迟跟踪以进行任意 ID。任意 ID 是任何不是流的第一个条目的 ID、最后一个条目或零 ("0-0") ID 的 ID。这在您确切知道任意 ID 与流的最后一个条目(不包括任意 ID)之间有多少个条目时很有用。在这种情况下,entries_read
可以设置为流的 entries_added
减去条目数量。
RESP2/RESP3 响应
简单字符串响应:OK
。历史
- 从 Redis 版本 7.0.0 开始:添加了可选的
entries_read
参数。