全部產品
Search
文件中心

ApsaraMQ for MQTT:資料流出規則管理

更新時間:Dec 27, 2024

如需將雲Message QueueTT 版的資料匯出至其他阿里雲產品,您需建立資料流出規則。該規則用於將MQTT用戶端發送的訊息匯出到您配置的其他阿里雲產品中,從而實現直接調用雲產品的API讀取MQTT用戶端發送的訊息。

流程說明

資料流出

規則限制

限制項

限制值

說明

單一實例規則數量

100

如果預設限制不滿足,請聯絡雲Message QueueTT 版支援人員,DingTalk群號:35228338。

規則去重限制

同一個內部資源同種規則只能建立一個規則。

例如一個Group ID只能建立一個上下線通知規則,一個MQTT Topic只能建立一個資料流入規則和一個資料流出規則。

地區限制

不支援跨地區建立規則,規則的資料來源和資料目標所屬的執行個體必須處於同一地區。

例如,建立資料流出規則,資料來源雲Message QueueTT 版執行個體屬於華東1(杭州)地區,則資料目標雲訊息佇列 RocketMQ 版只能選擇華東1(杭州)地區的執行個體。

雲Message QueueTT 版執行個體版本

僅核心版本為V3.x.x的執行個體支援使用規則,V2.x.x的執行個體不支援使用規則。

雲Message QueueTT 版執行個體的核心版本可在控制台執行個體列表或執行個體詳情頁面查看。

雲訊息佇列 RocketMQ 版執行個體版本

僅4.0系列執行個體支援

雲Message QueueTT 版雲訊息佇列 RocketMQ 版通過訊息流程入或訊息流程出規則進行資料互連時,雲訊息佇列 RocketMQ 版僅4.0系列執行個體支援訊息流程入或流出規則,5.0系列執行個體不支援。

建立資料流出規則

  1. 登入雲Message QueueTT 版控制台,並在左側導覽列單擊实例列表

  2. 在頂部功能表列選擇目標地區,然後在執行個體列表中單擊執行個體名稱進入实例详情頁面。

  3. 在左側導覽列單擊规则管理,然後在頁面左上方,單擊创建规则

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

    1. 配置基本信息設定精靈頁面,填寫規則的基本資料,然後單擊下一步

      參數

      取值樣本

      說明

      規則ID

      111111

      規則的全域唯一標識,說明如下:

      • 只能包含字母、數字、短劃線(-)和底線(_),至少包含一個字母或數字。

      • 名稱長度限制在3~64字元之間,長於64字元將被自動截取。

      • 建立後無法更新。

      描述

      migrate from rocketmq

      對規則的描述。

      狀態

      啟用

      是否啟用當前規則,取值說明如下:

      • 啟用

      • 停用

      規則類型

      資料流出

      建立的規則類型,取值說明如下:

      • 資料流出:用於將雲Message QueueTT 版的資料匯出至其他阿里雲產品。詳細資料,請參見跨雲產品的資料流出

      • 資料流入:用於將其他阿里雲產品的資料匯入至雲Message QueueTT 版。詳細資料,請參見跨雲產品資料流入

      • 上下線通知:用於將擷取的雲Message QueueTT 版用戶端上下線事件數目據匯出至其他阿里雲產品。詳細資料,請參見MQTT用戶端上下線事件數目據流出

    2. 配置规则源設定精靈頁面,配置資料來源,然後單擊下一步

      參數

      取值樣本

      說明

      Topic

      TopicA

      指定您需匯出資料的源Topic,即雲Message QueueTT 版的Topic。

      重要

      雲Message QueueTT 版中Topic是多級結構,而雲訊息佇列 RocketMQ 版的Topic僅有一級,因此,雲Message QueueTT 版中的一級Topic映射到雲訊息佇列 RocketMQ 版的Topic,而子級Topic,包括二級、三級、n級Topic則映射到雲訊息佇列 RocketMQ 版的訊息屬性(Properties)中。具體映射關係,請參見MQTT與RocketMQ的訊息結構映射

    3. 配置规则目标設定精靈頁面,配置資料的流轉目標,然後單擊创建

      參數

      取值樣本

      說明

      目標服務類型

      訊息佇列 RocketMQ 版

      指定您需將源Topic的資料轉寄至的目標雲產品。

      說明

      當前僅支援雲訊息佇列 RocketMQ 版

      RocketMQ 執行個體

      MQ_INST_13801563067*****_BbyOD2jQ

      指定目標雲產品的執行個體ID,即雲訊息佇列 RocketMQ 版的執行個體ID。

      說明

      僅支援選擇和雲Message QueueTT 版執行個體為同一地區的雲產品執行個體。

      Topic

      TopicB

      指定目標雲產品的資源索引值,即雲訊息佇列 RocketMQ 版的Topic。源Topic的資料將流轉至TopicB。

    您可以在规则管理的規則列表查看到剛建立的資料流出規則。

說明 雲Message QueueTT 版雲訊息佇列 RocketMQ 版的訊息結構映射資訊,請參見MQTT和RocketMQ的訊息結構映射

編輯資料流出規則

  1. 在規則列表,找到您想編輯的規則,並在其操作列選擇更多 > 编辑
  2. 编辑规则頁面,您可以更新除規則ID以外的所有參數。
  3. 編輯完成後,在配置规则目标嚮導頁面單擊保存

刪除資料流出規則

  1. 在規則列表,找到您想刪除的規則,並在其操作列選擇更多 > 删除
  2. 在彈出的提示對話方塊,單擊確認

啟用資料流出規則

  1. 在規則列表,找到您想啟用的規則,並在其操作列選擇更多 > 启用
  2. 在彈出的提示對話方塊,單擊確認

停用資料流出規則

  1. 在規則列表,找到您想停用的規則,並在其操作列選擇更多 > 停用
  2. 在彈出的提示對話方塊,單擊確認

相關文檔

如需將其他阿里雲產品資料推送至用戶端,請參見資料流入規則管理