SDK参考概述

本文为您介绍云消息队列 RocketMQ 版支持的SDK版本信息。

各版本SDK说明

云消息队列 RocketMQ 版各版本SDK和功能支持情况如下所示:

下表中的✅表示支持该功能,❌表示不支持该功能。

对比项

RocketMQ 5.x gRPC SDK

RocketMQ 5.x Remoting SDK

RocketMQ 4.x/3.x SDK

RocketMQ ONS TCP 1.x SDK

RocketMQ ONS TCP 2.x SDK

RocketMQ ONS HTTP SDK

协议

gRPC协议v2

Remoting协议

Remoting协议

Remoting协议

gRPC协议v1

HTTP协议

可访问的实例

5.x系列实例

  • 5.x系列实例

  • 4.x系列实例

  • 5.x系列实例

  • 4.x系列实例

  • 5.x系列实例

  • 4.x系列实例

4.x系列实例

4.x系列实例

使用建议

推荐5.x gRPC SDK。

  • 多语言支持完善。

  • 后续所有新的功能和优化将会在5.x gRPC SDK上得到支持。

  • 如果5.x gRPC SDK的某些功能不能满足需求,则可以考虑使用5.x Remoting SDK。

  • 原业务已使用这些版本的客户端可继续正常使用。

  • 5.x系列实例兼容这些版本的SDK。

  • 不推荐使用这些版本的客户端,这些版本的SDK不支持后续的新功能和优化。

  • 只能访问4.x系列实例。

普通、顺序、事务、定时消息的发送功能

并发消费

顺序消费

广播消费

流式消费(连接 Flink 等)

消息轨迹

4.5.2及以上版本支持

生产者消费者客户端Metrics 指标数据

优雅下线

仅支持5.x系列实例

SDK使用限制

  • 同一个ConsumerGroup下的不同 Consumer 使用相同协议的客户端。

  • 同一ConsumerGroup下,从Remoting协议SDK升级至gRPC协议SDK的灰度过程中的注意事项:

    • 顺序投递的ConsumerGroup暂不支持升级。

    • 并发投递的ConsumerGroup可以支持平滑升级,期间会有少量消息重复。

  • 顺序投递ConsumerGroup如果同时满足以下a、b、c 三个步骤,会有顺序消费位点回退的风险:

    1. 该顺序consumerGroup先使用Remoting协议SDK运行。

    2. 因为业务需要将SDK升级为gRPC协议SDK。

    3. SDK回退到了Remoting协议SDK。

  • RocketMQ ONS TCP 2.x SDK只支持部分地域,详情请参见使用限制

RocketMQ 5.x gRPC SDK

协议

语言

相关文档

gRPC协议v2

Java SDK

C# SDK

Go SDK

Python SDK

C++ SDK

RocketMQ 5.x Remoting SDK

协议

语言

相关文档

Remoting协议

Java SDK

RocketMQ 4.x/3.x SDK

协议

语言

相关文档

Remoting协议

Java SDK

C++ SDK

RocketMQ ONS TCP 1.x SDK

协议

语言

相关文档

Remoting协议

Java SDK

C++ SDK

.NET SDK