XGROUP 创建

XGROUP CREATE key group <id | $> [MKSTREAM]
  [ENTRIESREAD entries-read]

从以下位置开始可用：

5.0.0

时间复杂度：

O（1）

ACL 类别：

@write, @stream, @slow,

创建新的消费组，唯一标识方式<groupname>对于存储在<key>

每个组在给定流中都有一个唯一的名称。 当已存在同名的消费组时，该命令会返回一个-BUSYGROUP错误。

该命令的<id>argument 从新组的角度指定流中最后一个传递的条目。 特殊 ID 是流中最后一个条目的 ID，但您可以将其替换为任何有效的 ID。$

例如，如果您希望组的使用者从头开始获取整个流，请使用 0 作为使用者组的起始 ID：

XGROUP CREATE mystream mygroup 0

默认情况下，XGROUP CREATEcommand 期望目标流存在，如果不存在，则返回错误。 如果流不存在，您可以使用可选的MKSTREAM子命令作为<id>:

XGROUP CREATE mystream mygroup $ MKSTREAM

要启用使用者组滞后跟踪，请指定可选的entries_readnamed 参数。 任意 ID 是指不是流的第一个条目、最后一个条目或零 （“0-0”） ID 的任何 ID。 使用它来了解任意 ID（不包括它）与流的最后一个条目之间有多少个条目。 将entries_read流的entries_added减去条目数。

RESP2/RESP3 回复

历史

• 从 Redis 版本 7.0.0 开始：添加了entries_readnamed 参数。