简介

最近更新时间:2025-11-20 02:19:33

我的收藏

概述

消息队列 RocketMQ 版(TDMQ for RocketMQ,简称 TDMQ RocketMQ 版)是一款分布式高可用的消息队列服务, 基于 Apache RocketMQ 的 4.x 和 5.x 架构提供不同的产品形态,支持 RocketMQ 4.4.x 及以上版本的客户端零改造接入,同时具备计算存储分离,灵活扩缩容的底层优势。TDMQ RocketMQ 版最多可以支持百万级 TPS 的吞吐量,适用于各类大规模、低延时、对可靠性要求高的在线消息业务场景。
本章节介绍的 TDMQ RocketMQ 5.x 版本 API 接口均为 API 3.0 接口。您可以调用 API 对 TDMQ RocketMQ 5.x 集群进行操作,例如创建集群、Topic 等。
TDMQ RocketMQ 5.x 支持的所有接口信息,请参见 5.x API 概览
TDMQ RocketMQ 4.x 支持的所有接口信息,请参见 4.x API 概览

术语表

TDMQ RocketMQ 版 API 接口的常见术语请参见下表:

术语 描述
集群 集群是 TDMQ RocketMQ 版中的一个资源维度,不同集群的 Topic、Group 等资源完全隔离。每个集群会有集群的资源限制例如 Topic 总数、消息保留时长等。
Topic Topic 表示一类消息的集合,每个主题包含若干消息,是 RocketMQ 进行消息订阅的基本单位。
Group 可分为生产者组和消费者组:
  • 生产者组:同一类 Producer 的集合,这类 Producer 发送同一类消息且发送逻辑一致。如果发送的是事务消息,且生产者发送后崩溃,则 Broker 服务器会联系同一个生产者组的其他生产者实例以提交或者回溯消费。
  • 消费者组:同一类 Consumer 的集合,这类 Consumer 通常消费同一类消息且消费逻辑一致。消费者组使得在消息消费方面实现了负载均衡和容错。消费者组的消费者实例必须订阅完全相同的 Topic。
  • Producer 生产者是 RocketMQ 系统中用来构建并传输消息到服务端的运行实体。生产者通常被集成在业务系统中,将业务消息按照要求封装成消息并发送至服务端。
    Consumer 消费者是 RocketMQ 中用来接收并处理消息的运行实体。消费者通常被集成在业务系统中,从服务端获取消息,并将消息转化成业务可理解的信息,供业务逻辑处理。

    其他相关术语请参见 基本概念

    使用限制

    TDMQ RocketMQ 版的使用限制请参见 配额与限制
    对于具体的参数限制,请参考各接口文档中的参数说明。

    API 快速入门

    您可以使用 API Explorer 工具在线调用 API。
    本文以 TDMQ RocketMQ 5.x 集群为例,通过 API Explorer 工具调用 API 接口的步骤如下:

    1. 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息,请参见 使用 API Explorer
    2. 调用 CreateInstance 接口,创建一个集群。
    3. 调用 CreateTopic 接口,在集群下创建一个 Topic。
    4. 调用 CreateConsumerGroup 接口,在集群下创建一个 Group。
    5. 调用 CreateRole 接口,在集群下创建一个角色,并为其授予集群的生产消费权限。
    6. 使用客户端收发消息(本操作不支持通过 API 接口完成)。