本文将为您详细讲解如何设置一条完整的规则。

操作步骤

  1. 单击规则引擎,单击创建规则,创建一条新的规则。
  2. 填写规则名称,选择数据格式


    • 规则名称:输入规则名称,用以区别各条规则。
    • 数据格式:支持JSON和二进制。因规则引擎基于Topic处理数据,此处的数据格式需与被处理Topic中的数据格式保持一致。
      说明 如果数据格式为二进制的数据,不支持转发至表格存储、时序时空数据库和云数据库RDS版。
  3. 找到刚创建的规则,单击管理,进入规则详情页,设置规则具体信息。


    1. 单击编写SQL,编写SQL,设置数据处理的具体规则。

      例如:以下SQL可以将deviceName从Basic_Light_001产品下,后缀为data的自定义Topic类中取出。

      说明 二进制数据可使用 to_base64(*)将原始数据转换成base64String,同时支持内置函数和条件筛选。


      参数设置解释如下,具体可参考SQL表达式函数列表

      • 规则查询语句:此处根据字段Topic条件,系统自动补充完整规则查询语句。
      • 字段:指定消息内容字段,此示例填deviceName() as deviceName
      • Topic:选择需要处理的消息Topic。
        • 自定义:选择自定义后,表明该Topic是您自定义的产品Topic。此时您需要在选择产品后,补充完整该Topic。
        • sys:选择sys后,表明该Topic是系统定义的产品Topic。此时您需要在选择产品后,还需要选择设备,选择系统定义的某个Topic。
      • 条件:规则触发条件。
    2. 单击转发数据一栏的添加操作,将数据转发至目的云产品。数据转发的具体实例,请参考使用实例目录下的具体文档。


    3. 单击转发错误数据一栏的添加错误操作,设置参数,将重试失败的错误消息转发至指定位置。


      说明
      • 正常操作和错误操作的转发目的地云产品不能相同。比如不能同时转发到表格存储。
      • 消息转发至云产品失败后,会进行重试。若重试失败,将根据错误操作设置转发错误消息。
      • 错误消息转发失败不会再进行重试。
      • 这里的错误消息仅针对因其他云产品实例问题导致的规则引擎转发失败错误。
      • 最多支持添加一个错误操作。
      • 错误消息格式:
        {
              "ruleName":"",
              "topic":"",
              "productKey":"",
              "deviceName":"",
              "messageId":"",
              "base64OriginalPayload":"",
              "failures":[
                {
                  "actionType":"OTS",
                  "actionRegion":"cn-shanghai",
                  "actionResource":"table1",
                  "errorMessage":""
                },
                {
                  "actionType":"RDS",
                  "actionRegion":"cn-shanghai",
                  "actionResource":"instance1/table1",
                  "errorMessage":""
                }
              ]
        
        }

        参数说明如下:

        参数 说明
        ruleName 规则名称
        topic 消息来源Topic
        productKey 产品Key
        deviceName 设备名称
        messageId 云端消息ID
        base64OriginalPayload Base64编码后的原始数据
        failures 错误详情,可能会有多个
        actionType 出错操作的类型
        actionRegion 出错操作的地域
        actionResource 出错操作的目的资源
        errorMessage 错误信息
  4. 返回至规则引擎页。单击启动,数据即可按照规则进行转发。


    您也可以:
    • 单击管理修改规则具体设置。
    • 单击删除删除对应规则。其中,启动中的规则不可删除。
    • 单击停止停止某条规则转发数据。