创建命名空间

最近更新时间:2025-09-24 14:37:41

我的收藏

操作场景

命名空间是 TDMQ Pulsar 版中的一个资源管理概念。用户不同的业务场景一般都可以通过命名空间做隔离,并且针对不同的业务场景设置专门的配置,例如消息保留时间。不同命名空间之间的 Topic 相互隔离,订阅相互隔离,角色权限相互隔离。命名空间可作为:
1. 流控和消息存储策略调整的最小集合(Topic 只能按命名空间分类一批一批地调整)。
2. 权限管控的最小集合,token 可以设定具备某个命名空间下所有 Topic 的读或者写的权限。

约束与限制

同一个命名空间下的 Topic 和订阅的名称唯一。
若您新建的 TDMQ Pulsar 版集群版本为2.6.1,则系统默认会创建一个 default 命名空间,该命名空间的默认消息过期时间为7天,该命名空间可以修改,不可删除。
若您新建的 TDMQ Pulsar 版集群版本为2.7.1及以上,则系统不会自动创建 default 命名空间。

前提条件

已创建好对应的集群。

操作步骤

2. 在左侧导航栏选择命名空间,选择好地域和集群后,单击新建
3. 在新建命名空间弹窗中,设置命名空间的相关属性配置:
参数
是否必选
说明
命名空间名称
设置命名空间的名称(创建后不可修改),不能为空,支持数字字母以及符号 “-_=:.”,长度不超过128个字符。
消息 TTL
未消费消息的过期时间,超时未 ACK 则跳过对该消息的处理 范围:60秒-15天
消息保留策略
持久化保留:无论是否消费,按照最大保留时间和最大存储空间进行持久化存储,到达限制后从后向前删除。
最大保留时间:从生产到 Topic 开始计算,经过该时间后删除;保留策略作用于已经 ACK 的消息,不影响未 ACK 的消息,未 ACK 在 TTL 过期才会进入到清理的队列。取值范围 60秒~15天。
最大存储空间:命名空间内的所有消息累计到达该大小限制后,按生产时间从后向前删除。最少 10 GB,取值会消耗集群配置。
消费即删除:一条消息被成功 ACK 后会在一定时间内被异步清理,节省存储空间。如果 Topic 下没有任何订阅,则异步清理会直接作用于刚生产的消息。
自动创建订阅
开启后,支持通过客户端自动创建订阅。
说明
填写命名空间的备注说明,不能超过128个字符。
4. 单击保存,完成创建。