管理 Topic

最近更新时间:2025-06-11 15:02:11

我的收藏

操作场景

MQTT 协议基于 Pub/Sub 模型,Topic 通常用来对系统生产的各类消息做一个集中的分类和管理。客户端可以订阅一个或多个 Topic,以便于接收和这些主题相关的消息。同样客户端也可以发布消息到某个 Topic,以便其他订阅该 Topic 的客户端接收到这些消息。根据标准 MQTT 协议,Topic 存在多级,且拥有动态的特性,中间用“/”分隔。
消息队列 MQTT 版默认支持 Topic 的自动创建,即无需创建 Topic 就可以直接进行消息的收发。
同时,为了便于客户进行 Topic 的管理,查看对应 Topic 聚合下的相关监控数据,消息队列 MQTT 版支持指定 Topic 聚合下的指标查看,如创建 Topic “AAA” 即维护了一级的 Topic 聚合,可以查看 “AAA/1”, “AAA/2” ,“AAA/BBB/CCC” 等 Topic 指标的聚合,便于及时查看关键业务的监控数据。

使用限制

单集群中基础版最多可创建100个 Topic,专业版最多可创建300个 Topic。

前提条件

已创建好对应的集群,详情参见 集群管理

操作步骤

创建 Topic

1. 登录 MQTT 控制台
2. 在左侧导航栏单击资源管理 > 集群管理,选择好地域后,单击目标集群的“ID”,进入集群基本信息页面。
3. 在顶部页签选择Topic,单击新建,填写好 Topic 名称和说明。



说明:
一级 Topic 主要为了帮助客户进行业务的区分和元数据的管理,后续的订阅关系查阅和消息查询都可以根据一级 Topic 来查询。
客户端在发送消息时,需要先新建一级 Topic,否则会出现报错,即如果您需要往 “TopicA/device” 发送消息,您需要先创建一级 Topic “TopicA”,后续可以往类似“TopicA/+”,"TopicA/#" 等多层级 Topic 发送消息。
如果当前业务使用时强依赖 Topic 的自动创建能力,并且数量超过当前规格限制可以通过工单 联系我们
4. 单击提交,在 Topic 列表中即可看见创建好的 Topic。

Topic 详情页

单击 Topic 名称,进入 Topic 详情页。在 Topic 详情页可以查看 Topic 的基本信息,同时可以输入子级 Topic的全名查找具体的 Topic,如果存在此 Topic,则会展示 Topic 的具体信息,例如在线订阅关系和在线客户端等等。




发送测试消息

创建 Topic 后,您可以在控制台进行发送消息测试,并在消息查询中查看刚刚发送消息的记录。
1. 在 Topic 列表中,单击操作栏单击发送测试消息,输入您要发送的二级 Topic 名称和消息体内容。

2. 单击发送,发送消息。在消息发送成功弹窗中单击消息查询可以查看刚刚发送的消息。

编辑 Topic

1. 在 Topic 列表中,找到需要编辑的 Topic ,单击操作栏中的编辑
2. 在弹出的对话框中可以对 Topic 说明进行编辑。
3. 单击提交即完成对 Topic 的编辑。

删除 Topic

批量删除:在 Topic 列表中,勾选所有需要删除的 Topic,单击左上角的批量删除,在弹出的提示框中,输入我知道了,单击删除,完成删除。
单个删除:在 Topic 列表中,找到需要删除的 Topic,单击操作列的删除,在弹出的提示框中,单击删除,完成删除。
注意:
Topic 删除后,该 Topic 下的所有配置将会被清空,且无法恢复,请谨慎执行。