Topic 管理

操作场景

Topic 是 TDMQ 中的核心概念。Topic 通常用来对系统生产的各类消息做一个集中的分类和管理，例如和交易的相关消息可以放在一个名为 “trade” 的 Topic 中，供其他消费者订阅。 在实际应用场景中，一个 Topic 往往代表着一个业务聚合，由开发者根据自身系统设计、数据架构设计来决定如何设计不同的 Topic。

本文档可以指导您使用 TDMQ 时，利用 Topic 对消息进行分类管理。

前提条件

已创建好对应的命名空间。

操作步骤

创建 Topic

1. 登录 TDMQ 控制台，在左侧导航栏单击【Topic 管理】。
2. 在 Topic 管理页面，单击【新建】，弹出新建 Topic 的对话框。
3. 在新建 Topic 对话框中，填写以下信息：
   • Topic 名称：最多64个字符，只能包含字母、数字、“-”及“_”。
   • 类型：选择消息类型，包括：普通、全局顺序、局部顺序、事务。
   • 分区数：全局顺序只有1个分区，其他为1-128个分区
   • 说明：填写 Topic 的说明信息，不超过128字符
4. 单击【保存】，在 Topic 列表中即可看见创建好的 Topic。

查询 Topic

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

编辑 Topic

1. 在 【Topic 管理】中，找到需要编辑的 Topic ，单击操作栏中的【编辑】。
2. 在弹出的对话框中可以对 Topic 的分区数（全局顺序型消息只有1个分区，不可编辑）和说明进行编辑。
3. 单击【提交】即完成对 Topic 的编辑。

发送消息

TDMQ 控制台支持手动发送消息，在控制台进行相应的操作即可实现消息发送给指定的 Topic 。

1. 在 【Topic 管理】中，找到需要编辑的 Topic ，单击操作列中的【发送消息】。
2. 在弹出的对话框中输入消息内容。消息长度不超过64KB。

3. 单击【提交】，完成消息的发送。消息发送后即可被 Topic 下的任意订阅者消费。

新增订阅

TDMQ 控制台支持手动创建订阅，在控制台进行相应的操作后即可完成订阅的创建。

1. 在【Topic 管理】中，找到需要创建订阅的 Topic ，单击操作列中的【新增订阅】。
2. 在弹出的对话框中输入订阅的名称和说明。
   • 订阅名称：只能包含字母、数字、“-”及“_”
   • 自动创建重试&死信队列：可以选择是否创建重试和死信 Topic
   • 说明：不超过128字符

3. 单击【提交】完成创建。 创建后可通过单击操作列的【查看订阅】，查看订阅了该 Topic 的订阅，即可在列表中看到刚刚创建的订阅。

说明：

• 如果没有选择自动创建重试和死信 Topic，TDMQ 会自动帮用户创建好一个重试队列和死信队列，以两个新的 Topic 呈现于 Topic 列表，分别以 “订阅名”+“retry” 和 “订阅名”+“dlq” 命名。
• 关于重试队列和死信队列的概念和用法请参考 重试队列和死信队列 文档。

删除 Topic

注意：

删除了 Topic 之后也会清除该 Topic 下积累的未消费消息，请谨慎执行。

1. 在【Topic 管理】中，找到需要删除的 Topic ，单击操作列中的【删除】，或者勾选多个 Topic 之后单击 Topic 列表顶部的【删除】。
2. 在弹出的提示框中，单击【提交】，完成删除。