命名空间管理

最近更新时间: 2026-06-30 15:06:00

操作场景

命名空间是 TDMQ RocketMQ 4.x 集群中的一个资源管理概念。用户不同的业务场景一般都可以通过命名空间做隔离,并且针对不同的业务场景设置专门的配置。不同命名空间之间的 Topic 相互隔离,订阅相互隔离,角色权限相互隔离。
本文档指导您使用消息队列 TDMQ RocketMQ 版时,创建多个命名空间,以便在同一个集群下将 TDMQ RocketMQ 版应用于不同的场景。

约束与限制

  • 仅 4.x 集群需要创建命名空间,5.x 集群无需创建。
  • 每个集群下最多可以创建10个命名空间。
  • 同一个命名空间下的 Topic 和 Group 的名称唯一。
  • 消息成功生产后,默认在服务端保留3天,无论是否被消费,到时间则自动删除。

操作步骤

创建命名空间

  1. 登录 RocketMQ 控制台,选择地域后,单击目标集群的 “ID”,进入基本信息页面。
  2. 在页面上方选择命名空间页签,单击新建进入创建命名空间页面。
  3. 在新建命名空间对话框,设置命名空间的相关属性配置。
    • 命名空间名称:设置命名空间的名称(创建后不可修改),3-32个字符,只能包含字母、数字及'_'
    • 命名空间描述:命名空间的备注说明
  4. 单击保存完成所在集群命名空间的创建。
    后续步骤:接下来就可以在该命名空间中 创建 Topic 进行消息的生产和消费。

获取接入地址

命名空间列表页,在 VPC 内网接入地址可获取命名空间的 TCP 协议接入地址。

修改命名空间

如果需要重新修改编辑,可以通过以下步骤操作:

  1. 命名空间列表页,单击操作列的编辑,进入编辑页面。
  2. 修改命名空间说明,单击保存完成修改。

删除命名空间

如果想删掉创建的命名空间,可以通过以下步骤操作:

  1. 命名空间列表页,单击操作列的删除
  2. 在删除的确认弹框中,单击确认,即可删除命名空间。