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系列实例

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 指标数据

优雅下线

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