全部产品
Search
文档中心

ApsaraMQ for RocketMQ:Ikhtisar referensi SDK

更新时间:Dec 19, 2025

Topik ini menjelaskan versi SDK yang didukung oleh ApsaraMQ for RocketMQ.

Versi SDK

Tabel berikut menjelaskan fitur-fitur yang didukung oleh berbagai versi SDK ApsaraMQ for RocketMQ.

Pada tabel berikut, ✅ menunjukkan bahwa fitur tersebut didukung, sedangkan ❌ menunjukkan bahwa fitur tersebut tidak didukung.

Item

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

Protokol

Protokol gRPC v2

Protokol Remoting

Protokol Remoting

Protokol Remoting

Protokol gRPC v1

Protokol HTTP

Instans yang dapat diakses

Instans seri 5.x

  • Instans seri 5.x

  • Instans seri 4.x

  • Instans seri 5.x

  • Instans seri 4.x

  • Instans seri 5.x

  • Instans seri 4.x

Instans seri 4.x

Instans seri 4.x

Rekomendasi

Gunakan 5.x gRPC SDK.

  • SDK ini menyediakan dukungan komprehensif untuk multiple bahasa.

  • 5.x gRPC SDK akan mendukung semua fitur dan optimasi baru.

  • Jika beberapa fitur pada 5.x gRPC SDK belum memenuhi kebutuhan Anda, Anda dapat menggunakan 5.x Remoting SDK.

  • Jika bisnis Anda sudah menggunakan client versi ini, Anda dapat terus menggunakannya.

  • Instans seri 5.x kompatibel dengan versi SDK ini.

  • Jangan gunakan client versi ini. Versi SDK ini tidak mendukung fitur dan optimasi baru.

  • Anda hanya dapat mengakses instans seri 4.x.

Kirim pesan normal, terurut, transaksi, dan terjadwal

Model berbasis topik ringan

Konsumsi konkuren

Konsumsi pesan secara terurut

Optimasi konkurensi untuk konsumsi pesan secara terurut

Konsumsi siaran

Konsumsi stream (terhubung ke Flink, dll.)

Jejak pesan

Didukung pada versi 4.5.2 dan yang lebih baru

Producer dan consumer data metrik client

Shutdown elegan

Hanya didukung untuk instans seri 5.x

Pengiriman batch

Batasan

  • Consumer dalam satu kelompok konsumen harus menggunakan client yang mendukung protokol yang sama.

  • Saat melakukan upgrade grayscale dari SDK protokol Remoting ke SDK protokol gRPC untuk kelompok konsumen yang sama, perhatikan hal berikut:

    • Upgrade tidak didukung untuk kelompok konsumen yang mengirimkan pesan terurut.

    • Kelompok konsumen yang mengirimkan pesan secara konkuren mendukung upgrade yang lancar. Sejumlah kecil pesan mungkin diduplikasi selama proses upgrade.

  • Untuk mengirim pesan ke topik terurut yang sama, semua client produsen harus menggunakan protokol yang sama, yaitu protokol Remoting atau protokol gRPC.

  • Untuk kelompok konsumen yang mengirimkan pesan terurut, offset konsumen untuk konsumsi pesan terurut mungkin dikembalikan (rollback) jika langkah-langkah berikut dilakukan:

    1. Kelompok konsumen untuk pesan terurut awalnya menggunakan SDK protokol Remoting.

    2. SDK kemudian di-upgrade ke SDK protokol gRPC.

    3. SDK dikembalikan lagi ke SDK protokol Remoting.

  • RocketMQ ONS TCP 2.x SDK hanya tersedia di beberapa wilayah. Untuk informasi selengkapnya, lihat Batasan.

RocketMQ 5.x gRPC SDK

Protokol

Bahasa

Referensi

Protokol gRPC v2

Java SDK

C# SDK

Go SDK

Python SDK

C++ SDK

SDK RocketMQ 5.x Remoting

Protokol

Bahasa

Referensi

Protokol Remoting

Java SDK

RocketMQ 4.x/3.x SDK

Protokol

Bahasa

Referensi

Protokol Remoting

Java SDK

C++ SDK

RocketMQ ONS TCP 1.x SDK

Protokol

Bahasa

Referensi

Protokol Remoting

Java SDK

C++ SDK

.NET SDK