操作场景
Topic 是 TDMQ RocketMQ 版中的核心概念。Topic 通常用来对系统生产的各类消息做一个集中的分类和管理,例如和交易的相关消息可以放在一个名为 “trade” 的 Topic 中,供其他消费者订阅。
在实际应用场景中,一个 Topic 往往代表着一个业务聚合,由开发者根据自身系统设计、数据架构设计来决定如何设计不同的 Topic。
本文档可以指导您使用 TDMQ RocketMQ 版时,利用 Topic 对消息进行分类管理。
操作步骤
创建 Topic
1. 登录 RocketMQ 控制台。
2. 在左侧导航栏选择 Topic 管理页签,选择好地域和集群后,单击新建进入创建 Topic 页面。
3. 在新建 Topic 对话框中,填写以下信息。
Topic 名称:填写 Topic 名称(创建后不可修改),3-100个字符,只能包含字母、数字、“%”、“-”及“_”
类型:选择消息类型,包括“普通消息、顺序消息、延时消息和事务消息(关于消息类型的说明,请参见 消息类型)”。不同消息类型的 Topic 不能混用,例如您创建的普通消息的 Topic,不能用于收发其他类型的消息。
标签:标签用于对 Topic 资源分类管理。使用方法请参见 标签管理。
队列数:选择队列数量,最大支持16队列。多队列可以提高单 Topic 的生产消费性能,但是非顺序消息的场景下无法保证顺序性。
消息保留时间:消息持久化后的保留时间,过期不论是否消费均删除。仅专业版和铂金版集群支持在 Topic 维度调整消息保留时间,体验版和基础版支持在集群维度进行调整。
Topic 说明:填写 Topic 的说明信息,最长128个字符。
4. 单击提交,在 Topic 列表中即可看见创建好的 Topic。

1. 登录 TDMQ RocketMQ 版控制台。
2. 在左侧导航栏选择 Topic 管理页签,选择好地域和集群后,单击新建进入创建 Topic 页面。
3. 在新建 Topic 对话框中,填写以下信息。
Topic 名称:填写 Topic 名称(创建后不可修改),3-127个字符,只能包含字母、数字、“-”及“_”
类型:选择消息类型,包括“普通消息、顺序消息、延时消息和事务消息(关于消息类型的说明,请参见 消息类型)”。不同消息类型的 Topic 不能混用,例如您创建的普通消息的 Topic,不能用于收发其他类型的消息。
标签:标签用于对 Topic 资源分类管理。使用方法请参见 标签管理。
队列数:选择队列数量,最大支持16队列。多队列可以提高单 Topic 的生产消费性能,但是非顺序消息的场景下无法保证顺序性。
说明:填写 Topic 的说明信息
4. 单击提交,在 Topic 列表中即可看见创建好的 Topic。

发送测试消息
RocketMQ 控制台支持手动发送消息,在控制台进行相应的操作即可实现消息发送给指定的 Topic。
1. 在 Topic 管理列表中,单击目标 Topic 操作栏的发送测试消息。
2. 在弹窗中输入消息 Key,消息 Tag 和消息内容,单击发送。

查看生产者信息
说明:
4.x 虚拟集群不支持查看生产者信息。
1. 在 Topic 管理列表中,单击目标 Topic 的“名称”,进入 Topic 详情页。
2. 在 Topic 详情页,可以查看当前 Topic 下生产者的相关信息。

查看订阅的 Group
1. 在 Topic 管理列表中,单击目标 Topic 的“名称”,进入 Topic 详情页。
2. 选择订阅 Group 页签,展示订阅该 Topic 的 Group 信息。
3. 在订阅关系列表中,如果当前 Topic 下的 Group 处于离线状态(即没有在线客户端),则可以在操作列单击取消订阅以清理历史订阅关系数据,避免历史脏数据的影响。

查看 Topic 队列详情
说明:
仅 4.x 专享集群支持查看 Topic 队列详情。
在 Topic 详情页,可以查看当前 Topic 下分布在各个 Broker 节点上的队列情况。

查询 Topic
您可以在 Topic 管理列表页右上角的搜索框中,通过 Topic 名称进行搜索查询,TDMQ RocketMQ 版将会模糊匹配并呈现搜索结果。

调整消息保留时间
为了方便用户根据不同的业务要求调整消息的保留时间,5.x 专业版和铂金版集群支持按照 Topic 粒度调整消息的保留时间。在专业版和铂金版集群购买时,默认所有 Topic(主题)的初始化消息保留时间为 3 天,在使用过程中,用户可以根据不同的业务需求进行调整,消息保留时间的范围为 1-7 天,如用户需要更长的消息保留时间,可以通过工单联系调整。
要修改 Topic 的消息保留时间,如下图所示,在 Topic 管理 列表中,找到需要编辑的 Topic ,单击操作栏中的编辑。

元数据导入导出
元数据导出
您可以通过 Topic 管理页右上角的 
按钮直接导出元数据,元数据的导出格式为 .xlsx 的表格文件。

元数据导入
如果您需要将一个集群的 Topic 信息载入到另一个集群内,在导出元数据后,您可以单击 Topic 管理列表页右上角的 
按钮,将 Topic 数据导入到指定的集群内。

删除 Topic
批量删除:在 Topic 管理列表中,勾选所有需要删除的 Topic,单击左上角的批量删除,在弹出的提示框中,单击删除即可。
单个删除:在 Topic 管理列表中,找到需要删除的 Topic,单击操作列的删除,在弹出的提示框中,单击删除即可。
注意:
删除了 Topic 之后,Topic 下所有配置和相关数据以及积累的未消费消息都会被清理,请谨慎执行。
在单个删除或批量删除 Topic 时,控制台会对当前 Topic 的数据进行检验,如下图所示。
