队列管理

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

操作场景

本文介绍如何在 TDMQ CMQ 版控制台创建队列服务和向消息接受侧发送消息的操作步骤。

进入队列列表

登录 TDMQ 控制台,在左侧导航栏选择队列服务,选择好地域。

新建队列

  1. 在队列列表页面,单击新建,设置队列服务基本信息。

    参数说明
    队列名称Queue name为队列服务的主键,不区分大小写,作为资源的唯一标识,调用API接口进行操作时,以Queue name为准,无法修改
    消息最长未确认时间范围30秒到12小时,如果消费客户端在获取到消息后超过此时间仍未进行消息的确认,则服务端会自动确认该消息。
    设定定时时间后,TTL 的时间依旧会从发送消息的时间点开始算消息的最长保留时间;例如定时到2小时后发送,消息最长未确认时间如果设置为1小时的话,则消息在1小时后会被删除,则延时消息会丢失。这种情况下要确保消息最长未确认时间要大于延时的时间,否则消息到期前会被删除。 
    消息接收长轮询等待时间长轮询等待时,一个消息消费请求只会在取到有效消息或长轮询超时时才返回响应,类似于Ajax请求的长轮询;单位秒,推荐设置为3秒以下,有效值范围为0秒到30秒,设置过高可能造成消息重复的概率提升。
    取出消息隐藏时长该项为队列的VisibilityTimeout属性,单位为秒,有效值范围1秒到43200秒,也即1秒到12小时。每条Message都有个默认的VisibilityTimeout,Worker在接收到消息后,timeout就开始计时了。如果Worker在timeout时间内没能处理完Message,那么消息就有可能被其他Worker接收到并处理。
    死信队列死信队列用于处理无法被正常消费的消息。达到最大重试次数后,若消费依然失败,则表明消费者在正常情况下无法正确地消费该消息,此时,MQ 不会立刻将消息丢弃,而是将其发送到该消费者对应的特殊队列中
    消息回溯若未开启“消息回溯”能力,则消费者已消费,且确认删除的消息,会立即删除,开启该功能时,须指定回溯的“可回溯周期”,“可回溯周期”的范围,必须小于等于消息的生命周期。建议将回溯周期与消息的生命周期设置为相同的值,便于定位问题。
  2. 单击确认,在队列服务列表可以看到创建好的队列服务。

发送消息

  1. 在队列列表页面,单击目标队列操作列的发送消息。
  2. 填写消息内容,单击发送,向消息接收侧发送测试消息。

    说明:

    填写发送的内容,至少1Byte,最大长度受限于设置的队列消息最大长度属性。