文档

主题(Topic)

更新时间:

本文介绍轻量消息队列(原 MNS)中主题(Topic)的定义、模型关系、队列属性及使用限制。

定义和模型关系

轻量消息队列(原 MNS)中,一个主题是一个存储消息的容器。主题里的消息可以被订阅到多种渠道进行消费,订阅类型包括队列、HTTP、短信服务邮件推送、移动终端。

每个订阅类型可以订阅主题里的所有消息,也可以配置消息过滤规则,通过tag过滤消息。

image

功能说明

  • 至少一次(At least once):在消息保存时长和最大投递次数范围内的消息,每一条都将被接收方接收并处理至少一次。

  • 批量处理:支持批量发送消息,每批最多处理16条消息。

  • 多种订阅类型:主题中的消息可以投递到队列、HTTP服务、短信服务邮件推送、移动终端多种类型终端。

  • 消息过滤:订阅渠道可以通过tag过滤消息,只订阅符合过滤规则的消息。

主题属性

主题名称

  • 定义:主题的名称,用于标识主题,集群内全局唯一。

  • 取值:120个字符以内,必须以英文字母开头,剩余名称可以是英文、数字、短划线(-)。

消息最大长度

  • 定义:主题的MaximumMessageSize属性,表示允许发送到该主题的消息体的最大长度,单位:KB。

  • 取值:1~64 KB,默认值:64 KB。

启用日志功能

  • 定义:开启日志功能后,SMQ将自动推送该主题的操作日志到指定的LoggingBucket中。然后您可以通过日志查看消息轨迹,消息延迟以及其他信息。更多信息,请参见日志管理

  • 取值:true/false。

使用限制

限制项

限制值

说明

命名长度

120字符

超过该限制,主题创建失败。

主题数量

1000个

消息大小

64 KB

超过该限制,消息会被丢弃。

单个主题订阅数

100个

消息保存时间

1天

超过时间将自动滚动删除,建议按照需求设置。

消息过滤标签

1个

用于消息过滤,不超过16个字符。