Redis 与缓存 / 系统课时

创建 Consumer Group

创建 Consumer Group

本课解决 Redis Streams 消费组的初始化问题:创建 group,理解它记录的投递起点,并根据是否需要回放历史消息正确选择 0 或 $。完成后,你还能用 XINFO GROUPS 验证创建结果。

学习目标

  • 能使用 XGROUP CREATE 创建消费组并指定初始位置
  • 能区分 Stream、consumer group 和 consumer 的职责
  • 能根据是否回放历史消息选择 0 或 $

理解 Stream、Group 与 Consumer

Stream 是按 Entry ID 排序保存消息的日志;consumer group 建立在某个 Stream 上,维护该组自己的投递位置和待确认消息;consumer 则是组内具体的消费身份,例如 worker-a。创建 group 不会自动创建 consumer,consumer 通常在客户端第一次以该名称读取时出现,也可以显式创建。

同一个 Stream 可以存在多个彼此独立的 group,每个 group 都维护自己的 last-delivered-id。因此,“从哪里开始投递”是 group 的状态,不是 Stream 的全局游标,也不是某个 consumer 单独保存的位置。

Stream、消费组、消费者与起始位置关系

创建消费组并设置起点

XGROUP CREATE key group <id | $> 中的 id 用来设置新 group 的初始 last-delivered-id。特殊值 $ 表示创建 group 时 Stream 中最后一条 Entry 的 ID;它不是固定值,也不是 XGROUP CREATE 返回的 ID。

下面先写入两条消息,再以 $ 创建消费组。建议只在独立测试环境使用未占用的 key 和 group 名称执行。

bash
redis-cli XADD orders:group-demo '*' order_id 1001 status CREATED
redis-cli XADD orders:group-demo '*' order_id 1002 status PAID
redis-cli XGROUP CREATE orders:group-demo order-workers '$'

预期输出:

text
<ID>
<ID>
OK

前两行 <ID> 是两次 XADD 实际生成的 Entry ID,执行时间不同,值也不同;第三条命令只返回 OK。因为创建时使用 $,此时 group 的 last-delivered-id 应等于第二次 XADD 返回的实际 ID,而不是某个固定示例值。

如果目标 Stream 可能尚不存在,可以在创建命令末尾加 MKSTREAM。它只负责在 key 不存在时先创建空 Stream,不会改变 0 与 $ 的起点语义。

选择 0 与 $

选择起点前先判断:新 group 是否需要处理创建前已经存在的消息。使用 0 时,Redis 将初始位置设为 Stream 起点之前,也就是 0-0;之后使用 XREADGROUP 的 > 读取尚未投递的新消息时,现有 Entry 仍在该 group 的可投递范围内。

使用 $ 时,Redis 把创建 group 时 Stream 的最后一条 Entry 作为初始 last-delivered-id。创建前的历史 Entry 位于该位置之前,因此后续使用 > 读取时,通常只会获得创建之后新增且尚未投递给该 group 的消息。

起点 创建后的 group 位置 适用场景
0 last-delivered-id 从 0-0 起步 需要回放已有历史消息
$ 指向创建时最后一条 Entry 只处理创建后的新消息

验证创建结果

创建完成后,用 XINFO GROUPS 检查 group 的状态。

bash
redis-cli --raw XINFO GROUPS orders:group-demo

预期结果中至少应包含以下关键信息:

text
name
order-workers
consumers
0
pending
0
last-delivered-id
<ID>

这里的 <ID> 应与创建 group 前第二次 XADD 返回的实际 Entry ID 一致。Redis 7.0 及以上版本通常还会返回 entries-read、lag 等字段,不同版本的完整字段数量可能不同。

此时 consumers 为 0、pending 为 0 都是正常现象,因为创建 group 本身既不会创建 consumer,也不会投递消息。确认 group 名称正确,且 last-delivered-id 与所选起点一致,就说明消费组初始化符合预期。

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

目录与阅读设置

记录一个想法

创建 Consumer Group

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

登录哪都通