Golang 操作 Redis：Stream 操作用法 - go-redis 使用指南

文章目录 

• Redis Stream 简介
• go-redis 中 Stream 操作的方法
• go-redis Stream 操作方法详细讲解及示例代码
• 常见问题
  • 未决消息是什么意思？没有 ack 的消息会如何处理？
  • XClaim 和 XAck 的作用是什么？
    • XAck - 确认消息已被处理
    • XClaim - 重新分配未确认消息
  • XLen 返回的长度为何是 4，而不是 2？
  • 消息的删除时机
    • 自动裁剪清理流的方式
  • XReadGroupArgs 中 Streams 字段中的 ">" 代表什么意思？
  • 同一个组内多个消费者时的消费策略
  • 如何使用 Redis Stream 实现消费者的广播模式？
• 结语

在上一篇文章中，我们解释了 Redis 中 Cuckoo Filter 操作用法。在这篇文章中，我们将深入了解 Redis 的 Stream 数据类型及其操作方法。Stream 是 Redis 在 5.0 版本引入的一种强大的数据结构，用于实现消息队列、事件日志等实时数据流处理场景。在这篇文章中，我们将学习如何使用 go-redis 操作 Redis Stream，并通过一个完整的生产者和消费者的示例来演示各个方法的具体用法。

👉 点击查看 go-redis 使用指南目录

在《go-redis 使用指南》系列文章中，我们将详细介绍如何在 Golang 项目中使用 redis/go-redis 库与 Redis 进行交互。以下是该系列文章的全部内容：

1. Golang 操作 Redis：快速上手 - go-redis 使用指南
2. Golang 操作 Redis：连接设置与参数详解 - go-redis 使用指南
3. Golang 操作 Redis：基础的字符串键值操作 - go-redis 使用指南
4. Golang 操作 Redis：如何设置 key 的过期时间 - go-redis 使用指南
5. Golang 操作 Redis：Hash 哈希数据类型操作用法 - go-redis 使用指南
6. Golang 操作 Redis：Set 集合数据类型操作用法 - go-redis 使用指南
7. Golang 操作 Redis：为 Hash 中的字段设置过期时间 - go-redis 使用指南
8. Golang 操作 Redis：List 列表数据类型操作用法 - go-redis 使用指南
9. Golang 操作 Redis：SortedSet 有序集合数据类型操作用法 - go-redis 使用指南
10. Golang 操作 Redis：bitmap 数据类型操作用法 - go-redis 使用指南
11. Golang 操作 Redis：事务处理操作用法 - go-redis 使用指南
12. Golang 操作 Redis：地理空间数据类型操作用法 - go-redis 使用指南
13. Golang 操作 Redis：HyperLogLog 操作用法 - go-redis 使用指南
14. Golang 操作 Redis：Pipeline 操作用法 - go-redis 使用指南
15. Golang 操作 Redis：PubSub发布订阅用法 - go-redis 使用指南
16. Golang 操作 Redis：布隆过滤器（Bloom Filter）操作用法 - go-redis 使用指南
17. Golang 操作 Redis：Cuckoo Filter操作用法 - go-redis 使用指南
18. Golang 操作 Redis：Stream操作用法 - go-redis 使用指南

Redis Stream 简介

Redis Stream 是一种日志数据结构，类似于 Kafka 中的 Topic，可以用来存储和管理时间序列数据。它支持消息的持久化、消费组、消息确认等特性，因此非常适用于实现消息队列、事件处理和日志聚合等场景。

常见的使用场景包括：

• 消息队列：Stream 允许多个生产者和消费者进行消息的读写，并支持消费组功能，方便实现多消费者消费不同消息。
• 事件日志：Stream 可以记录发生的事件，并且支持按照时间顺序查询和消费这些事件。
• 实时数据处理：Stream 适合实时处理数据流，如物联网数据、用户行为日志等。

相关阅读推荐：Redis Streams 实践指南：在 Golang 中使用 Redis 作为消息队列

go-redis 中 Stream 操作的方法

在 go-redis 中，Stream 操作提供了丰富的接口来处理消息的生产、消费以及管理。以下是这些方法的名称及其功能描述：

• XAdd - 向 Stream 添加一条消息。
• XDel - 删除 Stream 中指定 ID 的消息。
• XLen - 获取 Stream 中消息的数量。
• XRange - 按消息 ID 范围获取 Stream 中的消息。
• XRangeN - 按消息 ID 范围获取 Stream 中的指定数量的消息。
• XRevRange - 按消息 ID 范围逆序获取 Stream 中的消息。
• XRevRangeN - 按消息 ID 范围逆序获取 Stream 中的指定数量的消息。
• XRead - 从多个 Stream 中读取消息。
• XReadStreams - 从多个指定的 Stream 中读取消息。
• XGroupCreate - 创建消费组。
• XGroupCreateMkStream - 创建消费组并在 Stream 不存在时自动创建。
• XGroupSetID - 设置消费组的 ID。
• XGroupDestroy - 删除消费组。
• XGroupCreateConsumer - 为消费组创建消费者。
• XGroupDelConsumer - 删除消费组中的消费者。
• XReadGroup - 从消费组中读取消息。
• XAck - 确认消费组中的消息。
• XPending - 获取消费组中待处理消息的概要信息。
• XPendingExt - 获取消费组中待处理消息的详细信息。
• XClaim - 将待处理消息分配给另一个消费者。
• XClaimJustID - 只返回待处理消息的 ID，不返回消息内容。
• XAutoClaim - 自动分配超时的待处理消息给当前消费者，并返回消息内容。
• XAutoClaimJustID - 自动分配超时的待处理消息给当前消费者，并只返回消息 ID。
• XTrimMaxLen - 按最大长度修剪 Stream。
• XTrimMaxLenApprox - 按近似最大长度修剪 Stream。
• XTrimMinID - 按最小 ID 修剪 Stream。
• XTrimMinIDApprox - 按近似最小 ID 修剪 Stream。
• XInfoGroups - 获取 Stream 中所有消费组的信息。
• XInfoStream - 获取 Stream 的基本信息。
• XInfoStreamFull - 获取 Stream 的详细信息。
• XInfoConsumers - 获取消费组中的消费者信息。

go-redis Stream 操作方法详细讲解及示例代码

接下来，我们将通过一个完整的生产者和消费者的示例来演示这些方法的具体用法。示例代码展示了如何在 Redis 中实现一个简单的消息队列，包含消息的生产、消费和管理。

阅读全文：Golang 操作 Redis：Stream 操作用法 - go-redis 使用指南 - 阿小信的博客