为了适用不同场景的需求,Pulsar 支持四种订阅模式:Exclusive、Shared、Failover、Key_Shared。
独占模式(Exclusive)
Exclusive 独占模式(默认模式):一个 Subscription 只能与一个 Consumer 关联,只有这个 Consumer 可以接收到 Topic 的全部消息,如果该 Consumer 出现故障了就会停止消费。
Exclusive 订阅模式下,同一个 Subscription 里只有一个 Consumer 能消费 Topic,如果多个 Consumer 订阅则会报错,适用于全局有序消费的场景。
Consumer<byte[]> consumer = pulsarClient.newConsumer()
.topic("persistent://pulsar-xxx/sdk_java/topic1")
.subscriptionName("sub_topic1")
.subscriptionType(SubscriptionType.Exclusive)
.subscribe();
共享模式(Shared)
消息通过 round robin 轮询机制(也可以自定义)分发给不同的消费者,并且每个消息仅会被分发给一个消费者。当消费者断开连接,所有被发送给他,但没有被确认的消息将被重新安排,分发给其它存活的消费者。
Consumer<byte[]> consumer = pulsarClient.newConsumer()
.topic("persistent://pulsar-xxx/sdk_java/topic1")
.subscriptionName("sub_topic1")
.subscriptionType(SubscriptionType.Shared)
.subscribe();
灾备模式(Failover)
当存在多个 consumer 时,将会按字典顺序排序,第一个 consumer 被初始化为唯一接受消息的消费者。当第一个 consumer 断开时,所有的消息(未被确认和后续进入的)将会被分发给队列中的下一个 consumer。
Consumer<byte[]> consumer = pulsarClient.newConsumer()
.topic("persistent://pulsar-xxx/sdk_java/topic1")
.subscriptionName("sub_topic1")
.subscriptionType(SubscriptionType.Failover)
.subscribe();
多个 Failover 模式消费者如下图所示:
KEY 共享模式(Key_Shared)
当存在多个 Consumer 时,将根据消息的 Key 进行分发,Key 相同的消息只会被分发到同一个消费者。
注意:
Key_Shared 本身在使用上存在一定的限制条件,由于其工程实现复杂度较高,在社区版本迭代中,不断有对 Key_Shared 的功能进行改进以及优化,整体稳定性相较 Exclusive,Failover 和 Shared 这三种订阅类型偏弱。如果上述三种订阅类型能满足业务需要,可以优先选用上述三种订阅类型。
专业集群可以保证相同 KEY 的消息按顺序投递;虚拟集群无法保障消息投递顺序。
Key_Shared 使用建议
什么时候才考虑用 Key_Shared 订阅模式
如是普通的生产消费场景,建议直接选用 Shared 模式即可。
若需要让相同 Key 的消息分给同一个消费者,这个时候 Shared 订阅模式无法满足用户需求。有两种方式可以选择:
选择 Key_Shared 订阅模式。
通过多分区主题 + Failover 订阅模式实现。
什么场景下适合用 Key_Shared 订阅
Key 数量多且每个 Key 的消息分布相对均匀。
消费处理速度快,无消息堆积的情况。
如果在生产过程中不能保证上面的两个条件同时满足,建议用多分区主题 + Failover 订阅。
代码示例
Key_Shared 订阅示例
默认情况下,Pulsar 在生产消息时是开启 Batch 功能的,Pulsar 的 Batch 消息解析是在 Consumer 侧处理的。所以在 Broker 侧一个 Batch 消息是被当作一条 Entry 处理的,所以对于 Key_shared 的基于消息 Key 有序订阅类型来说,是没办法处理这种 Case 的,因为不同 Key 的消息有可能被打包到同一个 Batch 中。针对这种情况在创建 Producer 时有如下两种规避方式:
1. 禁用 Batch。
Producer<byte[]> producer pulsarClient.newProducer()
.topic(topic)
.enableBatching(false)
.create();
MessageId msgId = producer.newMessage()
.value(value.getBytes(StandardCharsets.UTF_8))
.key("youKey1")
.send();
2. 使用 key_based batch 类型。
Producer<byte[]> producer = pulsarClient.newProducer()
.topic(topic)
.enableBatching(true)
.batcherBuilder(BatcherBuilder.KEY_BASED)
.create();
MessageId msgId = producer.newMessage()
.value(value.getBytes(StandardCharsets.UTF_8))
.key("youKey1")
.send();
消费者代码示例:
Consumer<byte[]> consumer = pulsarClient.newConsumer()
.topic("persistent://pulsar-xxx/sdk_java/topic1")
.subscriptionName("sub_topic1")
.subscriptionType(SubscriptionType.Key_Shared)
.subscribe();
多分区主题 + Failover 订阅示例
注意:
在该模式下,每个分区同时只会分配给一个消费者实例。若消费者数量多于分区数量,超出数量的消费者无法参与消息,可以通过扩容分区数量不小于消费者数量解决。
在设计 Key 的时候尽量保证 Key 分布均匀。
Failover 模式下不支持延时消息。
生产者代码示例:
Producer<byte[]> producer pulsarClient.newProducer()
.topic(topic)
.enableBatching(false)
.create();
MessageId msgId = producer.newMessage()
.value(value.getBytes(StandardCharsets.UTF_8))
.key("youKey1")
.send();
消费者代码示例:
Consumer<byte[]> consumer = pulsarClient.newConsumer()
.topic("persistent://pulsar-xxx/sdk_java/topic1")
.subscriptionName("sub_topic1")
.subscriptionType(SubscriptionType.Failover)
.subscribe();
开启保序
TDMQ Pulsar 2.9.2 版本集群可以支持 KEY 的顺序投递。如需开启,需要在创建消费者实例时指定 keySharedPolicy。
Consumer<byte[]> consumer = pulsarClient.newConsumer()
.topic("persistent://pulsar-xxx/sdk_java/topic1")
.subscriptionName("sub_topic1")
.subscriptionType(SubscriptionType.Key_Shared)
.keySharedPolicy(KeySharedPolicy.autoSplitHashRange().setAllowOutOfOrderDelivery(false))
.subscribe();
注意:
集群 2.7.2 版本不支持开启保序,可能造成消息推送堵塞,无法消费;
开启了保序,消费者重启后可能会出现消费速率下降、消息堆积的情况,这是因为在保序模式下新消费者上线后,需要等待消费者上线之前的全部消息都被消费完成后(全部确认后),才能继续消费后面的消息。
本页内容是否解决了您的问题?