
# 配置设备数据转发MQS
#### 概述
ROMA Connect不会直接存储设备上报的数据，用户需要通过配置数据转发规则，把设备数据转发到其他服务进行存储。本实践中，把设备数据转发到ROMA Connect的消息集成MQS。
#### 操作步骤
1. 创建用于存储设备数据的消息Topic。
   1. 在左侧的导航栏选择"消息集成 MQS \> Topic管理"，单击页面右上角的"创建Topic"。
   
   2. 在创建Topic弹窗中填写Topic相关配置信息，然后单击"确定"，创建Topic。
      表1Topic配置 
      | 参数       | 配置说明                                                                                                |
      |:---|:---|
      | Topic名称  | 填写Topic的名称，自定义。                                                                                     |
      | 集成应用     | 选择[在ROMA Connect注册设备](https://support.huaweicloud.com/bestpractice-roma/roma_05_0002.html)中创建的集成应用。 |
      | 权限       | 为Topic所属的集成应用选择对Topic的操作权限，此处选择"发布+订阅"，即该Topic可用于生产和消费消息。                                           |
      | 分区数      | 合理设置分区数量，可以提升消息生产与消费的并发性能。                                                                          |
      | 副本数      | ROMA Connect会自动在每个副本上备份数据，当其中一个副本故障时数据依然可用，Topic的副本数越多，可靠性越高。                                       |
      | 老化时间（小时） | 超过老化时间后，Topic中存储的消息将会被删除。                                                                           |
      | 同步复制     | 客户端向Topic生产消息时，是否把消息复制给所有副本，然后才向消息客户端返回响应，此处不启用。                                                    |
      | 同步落盘     | 消息客户端向Topic生产的每条消息是否立即写入磁盘，此处不启用。                                                                   |
      | 标签       | 添加Topic的标签信息，用于快速过滤和查找Topic。                                                                        |
      | 敏感字段     | 填写Topic的消息敏感字段。若向Topic生成的消息中包含敏感字段，则包含敏感字段的整条消息内容会被屏蔽。此处不添加。                                        |
      | 描述       | 填写Topic的描述信息。                                                                                       |
         
      
    
2. 配置数据转发规则。
   1. 在左侧的导航栏选择"设备集成 LINK \> 规则引擎"，单击页面右上角的"创建规则"。
   
   2. 在创建规则弹窗中填写规则相关配置信息，完成后单击"确认"。
      表2规则配置 
      | 参数   | 配置说明                                                                                                |
      |:---|:---|
      | 应用名称 | 选择[在ROMA Connect注册设备](https://support.huaweicloud.com/bestpractice-roma/roma_05_0002.html)中创建的集成应用。 |
      | 规则名称 | 填写规则的名称，自定义。                                                                                        |
      | 规则描述 | 填写规则的描述信息。                                                                                          |
      | 状态   | 是否启用该规则，保持默认开启。                                                                                     |
         
      
   
   3. 在规则列表中单击[2.b]中创建的规则名称，进入规则详情页面。
   
   4. 在"数据源端"下单击"创建数据源端"，设置数据源端相关配置，然后单击"保存"。
      表3数据源端配置 
      | 参数       | 配置说明                                                                                               |
      |:---|:---|
      | 产品名称     | 选择[在ROMA Connect注册设备](https://support.huaweicloud.com/bestpractice-roma/roma_05_0002.html)中所创建的产品。 |
      | 设备名称     | 选择"全部设备"。                                                                                          |
      | Topic名称  | 选择设备发送消息的Topic，格式为：{产品标识}/out/+。                                                                   |
      | Topic级别  | Topic的级别，根据"设备名称"的选择自动适配，"设备名称"不做选择，默认为"产品级别"；"设备名称"选择具体设备则默认匹配为"设备级别"。                            |
      | base64编码 | 是否对转发的设备数据进行base64编码，此处不开启。                                                                        |
      | 包含设备信息   | 转发的设备数据是否包含设备信息，为方便后续识别转发数据所属的设备，此处开启。                                                             |
         
      
   
   5. 在"数据目的端"下单击"创建数据目的端"，设置数据目的端相关配置，然后单击"保存"，完成数据转发规则的配置。
      表4数据目的端配置 
      | 参数      | 配置说明                                                                                                      |
      |:---|:---|
      | 数据目的端   | 本实践中把数据转发到ROMA Connect的消息集成MQS，此处选择"ROMA MQS"。                                                            |
      | 连接地址    | 选择当前ROMA Connect实例的"消息集成 MQS内网连接地址"，您可以在ROMA Connect实例控制台的"实例信息"页面中查看得到。                                  |
      | Topic名称 | 选择[1]中创建的消息Topic。                                                          |
      | 用户名     | **仅当ROMA Connect实例的"MQS SASL_SSL"已开启时需要配置。** 填写"Topic名称"中Topic所属集成应用的Key。   |
      | 密码      | **仅当ROMA Connect实例的"MQS SASL_SSL"已开启时需要配置。** 填写"Topic名称"中Topic所属集成应用的Secret。 |
         
      
    
 
