服務端流轉
云消息隊列 MQTT 版支持與云消息隊列 RocketMQ 版的數據流轉功能,本文為您介紹數據流轉中的屬性字段的映射關系。
功能說明
云消息隊列 MQTT 版可以通過數據互通規則實現與其他阿里云產品的交互,例如云消息隊列 RocketMQ 版。規則的詳細信息,請參見規則管理。
使用限制
云消息隊列 MQTT 版的實例必須支持MQTT 5.0協議。
云消息隊列 RocketMQ 版的實例必須為4.x的實例。
屬性字段映射
云消息隊列 MQTT 版云端SDK和云消息隊列 RocketMQ 版都可以消費和發送MQTT 5.0的消息,并且可以設置與讀取用戶屬性,具體的屬性字段映射關系如下表所示。
MQTT參數 | RocketMQ屬性Key | 屬性可選值 | 說明 |
QoS | qoslevel | 0、1、2 | 云消息隊列 RocketMQ 版發給云消息隊列 MQTT 版消息時可以設置,如果不設置,默認為“1”; 云消息隊列 MQTT 版發給云消息隊列 RocketMQ 版的消息可以直接讀取。 |
MQTT全量Topic | topic | 具體的全量Topic字符串 | 不可設置,云消息隊列 MQTT 版發給云消息隊列 RocketMQ 版消息時,用于追蹤該消息的發送源的全量Topic。 |
MQTT子級Topic | mqttSecondTopic | 具體的子級Topic字符串 | 云消息隊列 RocketMQ 版發給云消息隊列 MQTT 版客戶端消息時如果需要子級Topic來做過濾,則設置,如不設置,默認為空; 云消息隊列 MQTT 版發給云消息隊列 RocketMQ 版的消息可以直接讀取。 |
客戶端接收消息顯示Topic | mqttRealTopic | 業務上希望客戶端收到消息時顯示的子級字符串 | 云消息隊列 RocketMQ 版發給云消息隊列 MQTT 版客戶端消息時如果希望客戶端收到消息后顯示成指定的子級Topic名稱,則可以設置;一般用于P2P消息,若不設置,P2P消息默認使用自己固定的Topic; 云消息隊列 MQTT 版發給云消息隊列 RocketMQ 版的消息時無該屬性。 |
clientId | clientId | 具體的Client ID字符串 | 不可設置,云消息隊列 MQTT 版發給云消息隊列 RocketMQ 版消息時,用于追蹤該消息的發送源的Client ID。 |
MQTT消息的用戶屬性 | mqtt5UserProperty | 長度不能超過8K, 例如 :
| 發送消息時指定的用戶屬性信息。 |
MQTT消息的過期時間 | mqtt5MsgExpireInterval | 0-65535,單位s | 發送消息時指定的過期時間。 |
MQTT消息的內容類型 | mqtt5ContentType | UTF-8 | 發送消息時指定的編碼類型。 |