《RocketMQ 官网》阅读笔记 RocketMQ 订阅 (Subscription)
订阅 (Subscription)
定义
订阅是 Apache RocketMQ 中消费者获取和处理消息的规则与状态设置。
订阅由消费者组动态注册到服务端(Broker)。消息会根据订阅中定义的过滤规则进行匹配和消费。
通过配置订阅,您可以控制以下消息行为:
- 消息过滤规则:这些规则用于定义消费者消费主题(Topic)中的哪些消息。通过配置消息过滤规则,消费者可以有效地获取所需的消息,并根据不同的业务场景指定消息接收范围。
- 消费状态:默认情况下,Apache RocketMQ 服务端提供持久化订阅。也就是说,在消费者组订阅了某个服务端后,即使组内的消费者重新连接,它们也可以从上次停止消费的位置继续消费消息。
订阅的判定规则
Apache RocketMQ 的订阅基于消费者组和主题进行设计。因此,订阅是指特定的消费者组对某个主题的订阅。以下描述了订阅的判定规则:
模型关系
下图展示了订阅在 Apache RocketMQ 领域模型中的位置。
内部属性
过滤类型
消息过滤规则的类型。为订阅设置消息过滤规则后,系统会根据该规则匹配主题中的消息。只有满足条件的消息才会投递给 消费者。此功能可帮助您根据需求对发送给消费者的消息进行分类。
- Tag 过滤:基于标签字符串进行全文本过滤和匹配。
- SQL92 过滤:基于 SQL 语法对消息属性进行过滤和匹配。
过滤表达式
- 自定义过滤规则的表达式。
- https://rocketmq.apache.ac.cn/docs/featureBehavior/07messagefilter/
行为约束
订阅一致性
Apache RocketMQ 基于消费者组管理订阅。因此,同一个消费者组内的消费者必须保持相同的消费逻辑。否则,会发生消费冲突,进而导致部分消息被错误地消费。
正确示例
//Consumer c1Consumerc1=ConsumerBuilder.build(groupA);c1.subscribe(topicA,"TagA");//Consumer c2Consumerc2=ConsumerBuilder.build(groupA);c2.subscribe(topicA,"TagA");错误示例
//Consumer c1Consumerc1=ConsumerBuilder.build(groupA);c1.subscribe(topicA,"TagA");//Consumer c2Consumerc2=ConsumerBuilder.build(groupA);c2.subscribe(topicA,"TagB");使用说明
请勿频繁修改订阅。
在 Apache RocketMQ 中,订阅与元数据以及过滤规则、消费进度等配置相关联。系统必须确保消费者组中所有消费者的消费行为、消费逻辑和负载策略保持一致。这些因素导致需要管理的关系网络非常复杂。因此,我们建议不要在生产环境中频繁修改订阅以变更业务逻辑。否则,客户端需要不断调整负载分布,这会导致消息接收问题。