數(shù)據(jù)流入規(guī)則管理
如需將其他阿里云產(chǎn)品的數(shù)據(jù)導入云消息隊列 MQTT 版，您需創(chuàng)建數(shù)據(jù)流入規(guī)則。該規(guī)則用于從您配置的阿里云產(chǎn)品中讀取數(shù)據(jù)并將數(shù)據(jù)通過MQTT協(xié)議推送到MQTT客戶端，從而實現(xiàn)直接調(diào)用阿里云產(chǎn)品的API發(fā)送數(shù)據(jù)到MQTT客戶端。
流程說明
規(guī)則限制
限制項 | 限制值 | 說明 |
單實例規(guī)則數(shù)量 | 100 | 如果默認限制不滿足，請聯(lián)系云消息隊列 MQTT 版技術(shù)支持，釘釘群號：35228338。 |
規(guī)則去重限制 | 同一個內(nèi)部資源同種規(guī)則只能創(chuàng)建一個規(guī)則。 | 例如一個Group ID只能創(chuàng)建一個上下線通知規(guī)則，一個MQTT Topic只能創(chuàng)建一個數(shù)據(jù)流入規(guī)則和一個數(shù)據(jù)流出規(guī)則。 |
地域限制 | 不支持跨地域創(chuàng)建規(guī)則，規(guī)則的數(shù)據(jù)源和數(shù)據(jù)目標所屬的實例必須處于同一地域。 | 例如，創(chuàng)建數(shù)據(jù)流出規(guī)則，數(shù)據(jù)源云消息隊列 MQTT 版實例屬于華東1（杭州）地域，則數(shù)據(jù)目標云消息隊列 RocketMQ 版只能選擇華東1（杭州）地域的實例。 |
云消息隊列 MQTT 版實例版本 | 僅新版本的實例支持。 | 新購的云消息隊列 MQTT 版實例默認為新版本實例，舊版實例已不支持購買。 |
云消息隊列 RocketMQ 版實例版本 | 僅4.0系列實例支持 | 云消息隊列 MQTT 版和云消息隊列 RocketMQ 版通過消息流入或消息流出規(guī)則進行數(shù)據(jù)互通時，云消息隊列 RocketMQ 版僅4.0系列實例支持消息流入或流出規(guī)則，5.0系列實例不支持。 |
注意事項
云消息隊列 MQTT 版通過配置的流入規(guī)則和云消息隊列 RocketMQ 版進行跨云產(chǎn)品的消息交互時，若云消息隊列 RocketMQ 版的服務端進行升級，則在升級期間，可能會造成云消息隊列 MQTT 版客戶端消費消息延遲。產(chǎn)品升級動態(tài)，請參見公告列表。
創(chuàng)建數(shù)據(jù)流入規(guī)則
登錄云消息隊列 MQTT 版控制臺，并在左側(cè)導航欄單擊實例列表。
在頂部菜單欄選擇目標地域，然后在實例列表中單擊實例名稱進入實例詳情頁面。
在左側(cè)導航欄單擊規(guī)則管理，然后在頁面左上角，單擊創(chuàng)建規(guī)則。
在創(chuàng)建規(guī)則頁面完成以下操作。
在配置基本信息配置向?qū)ы撁妫顚懸?guī)則的基本信息，然后單擊下一步。
參數(shù)
取值示例
說明
規(guī)則ID
111111
規(guī)則的全局唯一標識，說明如下：
只能包含字母、數(shù)字、短劃線（-）和下劃線（_），至少包含一個字母或數(shù)字。
名稱長度限制在3~64字符之間，長于64字符將被自動截取。
創(chuàng)建后無法更新。
描述
migrate from rocketmq
對規(guī)則的描述。
狀態(tài)
啟用
是否啟用當前規(guī)則，取值說明如下：
啟用
停用
規(guī)則類型
數(shù)據(jù)流入
創(chuàng)建的規(guī)則類型，取值說明如下：
數(shù)據(jù)流出：用于將云消息隊列 MQTT 版的數(shù)據(jù)導出至其他阿里云產(chǎn)品。詳細信息，請參見跨云產(chǎn)品的數(shù)據(jù)流出。
數(shù)據(jù)流入：用于將其他阿里云產(chǎn)品的數(shù)據(jù)導入至云消息隊列 MQTT 版。詳細信息，請參見跨云產(chǎn)品數(shù)據(jù)流入。
上下線通知：用于將獲取的云消息隊列 MQTT 版客戶端上下線事件數(shù)據(jù)導出至其他阿里云產(chǎn)品。詳細信息，請參見MQTT客戶端上下線事件數(shù)據(jù)流出。
在配置規(guī)則源配置向?qū)ы撁妫渲脭?shù)據(jù)源，然后單擊下一步。
參數(shù)
取值示例
說明
源服務類型
消息隊列 RocketMQ 版
指定您需將哪個源云產(chǎn)品的數(shù)據(jù)流入至云消息隊列 MQTT 版。
說明當前僅支持云消息隊列 RocketMQ 版。
RocketMQ 實例
MQ_INST_13801563067*****_BbyOD2jQ
指定源云產(chǎn)品的實例ID，即云消息隊列 RocketMQ 版的實例ID。
說明僅支持選擇和云消息隊列 MQTT 版實例為同一地域的云產(chǎn)品實例。
Topic
TopicA
指定源云產(chǎn)品的資源鍵值，即云消息隊列 RocketMQ 版的Topic。TopicA的消息將流轉(zhuǎn)至目標云消息隊列 MQTT 版的Topic。
在配置規(guī)則目標配置向?qū)ы撁妫渲脭?shù)據(jù)的流轉(zhuǎn)目標，然后單擊創(chuàng)建。
參數(shù)
取值示例
說明
Topic
TopicB
指定您需要將其他源云產(chǎn)品的數(shù)據(jù)導入至云消息隊列 MQTT 版的哪個目標Topic。
重要在云消息隊列 MQTT 版中Topic是多級結(jié)構(gòu)，而云消息隊列 RocketMQ 版的Topic僅有一級，因此，云消息隊列 MQTT 版中的一級Topic映射到云消息隊列 RocketMQ 版的Topic，而子級Topic，包括二級、三級、n級Topic則映射到云消息隊列 RocketMQ 版的消息屬性（Properties）中。具體映射關(guān)系，請參見MQTT與RocketMQ的消息結(jié)構(gòu)映射。
您可以在規(guī)則管理的規(guī)則列表查看到剛創(chuàng)建的數(shù)據(jù)流入規(guī)則。
編輯數(shù)據(jù)流入規(guī)則
- 在規(guī)則列表，找到您想編輯的規(guī)則，并在其操作列選擇。
- 在編輯規(guī)則頁面，您可以更新除規(guī)則ID以外的所有參數(shù)。
- 編輯完成后，在配置規(guī)則目標向?qū)ы撁鎲螕?b id="uicontrol-6fi-4dg-vca" data-tag="uicontrol" data-isbold="true" class="uicontrol">保存。
刪除數(shù)據(jù)流入規(guī)則
- 在規(guī)則列表，找到您想刪除的規(guī)則，并在其操作列選擇。
- 在彈出的提示對話框，單擊確認。
啟用流入規(guī)則
- 在規(guī)則列表，找到您想啟用的規(guī)則，并在其操作列選擇。
- 在彈出的提示對話框，單擊確認。
停用流入規(guī)則
- 在規(guī)則列表，找到您想停用的規(guī)則，并在其操作列選擇。
- 在彈出的提示對話框，單擊確認。
相關(guān)文檔
如需將客戶端數(shù)據(jù)推送至其他阿里云產(chǎn)品，請參見數(shù)據(jù)流出規(guī)則管理。