文档中心

消息队列 RocketMQ版

Group 管理

创建 Group

本文介绍在消息队列 RocketMQ版控制台创建 Group 的操作步骤。

背景信息

Group 即消费组（Consumer Group），是一类具有相同消费行为的消费者集合，用于分类管理不同的消费者。每个消费组消费不同种类的消息，且消息发布或订阅的逻辑一致。在消息队列 RocketMQ版中，您需要创建 Group，并通过 Group ID 标识不同类别的生产者或消费者。

说明

每个实例的 Group 数量配额与实例规格有关，例如各个规格实例可创建的 Group 数量请参考产品规格。

消费者必须配置 Group ID，生产者可以忽略 Group ID 配置。

目前支持的客户端协议为 TCP。

前提条件

已创建 RocketMQ 实例，且实例状态为运行中，详细操作步骤请参考创建实例。

操作步骤

登录消息队列 RocketMQ版控制台。

在实例列表页面，单击目标实例名称。

在Group管理页签，单击创建Group。

填写 Group 的相关参数，然后单击创建。

参数	说明
Group ID	Group 的名称。Group 命名规则如下：推荐以 GID- 或 GID_ 开头。长度范围为 3~120 个字符。只能包含英文、数字、中划线（-）、下划线（_）。同一实例下，Group 名称必须唯一。 Group 名称中不可包含以下保留字符或特殊前缀。保留字符：DEFAULT_CONSUMER、DEFAULT_PRODUCER、TOOLS_CONSUMER、FILTERSRV_CONSUMER、__MONITOR_CONSUMER、CLIENT_INNER_PRODUCER、SELF_TEST_P_GROUP、SELF_TEST_C_GROUP、CID_ONS-HTTP-PROXY、CID_ONSAPI_PERMISSION、CID_ONSAPI_OWNER、CID_ONSAPI_PULL、CID_RMQ_SYS_TRANS 特殊前缀：CID_RMQ_SYS_、CID_HOUSEKEEPING
消费模式	Group 的消费模式，选择后不可更改。可选模式如下： CLUSTERING：用于订阅非 Lite 类型的其它类型 Topic。 LITE_SELECTIVE：用于订阅 Lite 类型的Topic。仅已开启轻量主题功能的 5.x 版本实例支持该选项。更多信息，请参见轻量主题管理。说明仅消息队列 RocketMQ版的 5.x 版本实例需要设置该参数。
订阅 Topic 名称	当消费模式选择 LITE_SELECTIVE 时，您需要选择已创建的轻量主题，选择后不可更改。更多信息，请参见创建轻量主题。说明仅消息队列 RocketMQ版 5.x 版本，且已开启轻量主题功能的实例需要设置该参数。
是否顺序消费	表示服务端是否将消息顺序投递给消费者消费。否：默认配置，表示不是顺序投递，是并发投递。是：表示顺序投递。说明仅消息队列 RocketMQ版的 5.x 版本实例需要设置该参数。当消费模式为 LITE_SELECTIVE 时，该开关强制打开，不可关闭。
最大重试次数	表示消息可以重新被投递的最大次数。最大重试次数的配置范围为 1~100。超过最大重试次数还没被成功消费，消息将被投递至死信队列或丢弃。说明仅消息队列 RocketMQ版的 5.x 版本实例需要设置该参数。
描述	Group 的描述信息，长度为 0~256 个字符。

操作结果

成功创建 Group 之后，Group 管理页签中将显示此 Group 的基本信息，包括 Group ID、描述和客户端协议等。

单击 Group ID，进入 Group 详情页面。基本信息区域中展示当前 Group 的详细信息，包括Group ID、客户端协议、描述、所属实例。您还可以在当前页面中查看 Group 的消费详情。更多信息，请参见查看 Group 消费状态。

后续操作

Group 创建后，您可以通过调用 RocketMQ SDK，订阅目标 Topic，消费消息。

Java SDK

Go SDK

Python SDK

C++ SDK

最近更新时间：2026.06.03 15:04:53

这个页面对您有帮助吗？

有用

无用