全部产品
Search
文档中心

云消息队列 MQTT 版:数据流出规则管理

更新时间:Aug 08, 2024

如需将云消息队列 MQTT 版的数据导出至其他阿里云产品,您需创建数据流出规则。该规则用于将MQTT客户端发送的消息导出到您配置的其他阿里云产品中,从而实现直接调用云产品的API读取MQTT客户端发送的消息。

流程说明

数据流出

规则限制

限制项

限制值

说明

单实例规则数量

100

如果默认限制不满足,请联系云消息队列 MQTT 版技术支持,钉钉群号:35228338。

规则去重限制

同一个内部资源同种规则只能创建一个规则。

例如一个Group ID只能创建一个上下线通知规则,一个MQTT Topic只能创建一个数据流入规则和一个数据流出规则。

地域限制

不支持跨地域创建规则,规则的数据源和数据目标所属的实例必须处于同一地域。

例如,创建数据流出规则,数据源云消息队列 MQTT 版实例属于华东1(杭州)地域,则数据目标云消息队列 RocketMQ 版只能选择华东1(杭州)地域的实例。

云消息队列 MQTT 版实例版本

仅新版本的实例支持。

新购的云消息队列 MQTT 版实例默认为新版本实例,旧版实例已不支持购买。

云消息队列 RocketMQ 版实例版本

仅4.0系列实例支持

云消息队列 MQTT 版云消息队列 RocketMQ 版通过消息流入或消息流出规则进行数据互通时,云消息队列 RocketMQ 版仅4.0系列实例支持消息流入或流出规则,5.0系列实例不支持。

创建数据流出规则

  1. 登录云消息队列 MQTT 版控制台,并在左侧导航栏单击实例列表

  2. 在顶部菜单栏选择目标地域,然后在实例列表中单击实例名称进入实例详情页面。

  3. 在左侧导航栏单击规则管理,然后在页面左上角,单击创建规则

  4. 创建规则页面完成以下操作。

    1. 配置基本信息配置向导页面,填写规则的基本信息,然后单击下一步

      参数

      取值示例

      说明

      规则ID

      111111

      规则的全局唯一标识,说明如下:

      • 只能包含字母、数字、短划线(-)和下划线(_),至少包含一个字母或数字。

      • 名称长度限制在3~64字符之间,长于64字符将被自动截取。

      • 创建后无法更新。

      描述

      migrate from rocketmq

      对规则的描述。

      状态

      启用

      是否启用当前规则,取值说明如下:

      • 启用

      • 停用

      规则类型

      数据流出

      创建的规则类型,取值说明如下:

      • 数据流出:用于将云消息队列 MQTT 版的数据导出至其他阿里云产品。详细信息,请参见跨云产品的数据流出

      • 数据流入:用于将其他阿里云产品的数据导入至云消息队列 MQTT 版。详细信息,请参见跨云产品数据流入

      • 上下线通知:用于将获取的云消息队列 MQTT 版客户端上下线事件数据导出至其他阿里云产品。详细信息,请参见MQTT客户端上下线事件数据流出

    2. 配置规则源配置向导页面,配置数据源,然后单击下一步

      参数

      取值示例

      说明

      Topic

      TopicA

      指定您需导出数据的源Topic,即云消息队列 MQTT 版的Topic。

      重要

      云消息队列 MQTT 版中Topic是多级结构,而云消息队列 RocketMQ 版的Topic仅有一级,因此,云消息队列 MQTT 版中的一级Topic映射到云消息队列 RocketMQ 版的Topic,而子级Topic,包括二级、三级、n级Topic则映射到云消息队列 RocketMQ 版的消息属性(Properties)中。具体映射关系,请参见MQTT与RocketMQ的消息结构映射

    3. 配置规则目标配置向导页面,配置数据的流转目标,然后单击创建

      参数

      取值示例

      说明

      目标服务类型

      消息队列 RocketMQ 版

      指定您需将源Topic的数据转发至的目标云产品。

      说明

      当前仅支持云消息队列 RocketMQ 版

      RocketMQ 实例

      MQ_INST_13801563067*****_BbyOD2jQ

      指定目标云产品的实例ID,即云消息队列 RocketMQ 版的实例ID。

      说明

      仅支持选择和云消息队列 MQTT 版实例为同一地域的云产品实例。

      Topic

      TopicB

      指定目标云产品的资源键值,即云消息队列 RocketMQ 版的Topic。源Topic的数据将流转至TopicB。

    您可以在规则管理的规则列表查看到刚创建的数据流出规则。

说明 云消息队列 MQTT 版云消息队列 RocketMQ 版的消息结构映射信息,请参见MQTT和RocketMQ的消息结构映射

编辑数据流出规则

  1. 在规则列表,找到您想编辑的规则,并在其操作列选择更多 > 编辑
  2. 编辑规则页面,您可以更新除规则ID以外的所有参数。
  3. 编辑完成后,在配置规则目标向导页面单击保存

删除数据流出规则

  1. 在规则列表,找到您想删除的规则,并在其操作列选择更多 > 删除
  2. 在弹出的提示对话框,单击确认

启用数据流出规则

  1. 在规则列表,找到您想启用的规则,并在其操作列选择更多 > 启用
  2. 在弹出的提示对话框,单击确认

停用数据流出规则

  1. 在规则列表,找到您想停用的规则,并在其操作列选择更多 > 停用
  2. 在弹出的提示对话框,单击确认

相关文档

如需将其他阿里云产品数据推送至客户端,请参见数据流入规则管理