转发规则
大约 4 分钟featurerule
概念说明
转发规则用于将设备数据转发到第三方系统或从第三方系统接收数据，实现与外部平台的数据互通。支持 HTTP、MQTT、Database 等多种转发目标类型，可配置双向数据流（输入/输出），满足各种数据集成场景需求。
一、创建转发规则
- 登录物联网平台，选择【规则引擎】>【转发规则】，进入转发规则管理页面。
- 点击【创建转发规则】，填写转发名称、转发编码等基础信息。
- 其中转发编码支持自动生成，点击输入框右侧的【自动生成】按钮即可。
- 选择需要关联的产品，转发规则将应用于该产品下的设备数据。
- 创建成功后，可以在转发规则列表中查看。
二、配置数据流向
转发规则支持两种数据流向：
1. 输入
将数据从平台转发到目标系统，例如将设备上报的数据推送到业务系统。
- 适用场景：数据分析、业务处理、第三方集成
- 数据来源：设备上报数据、平台产生的事件数据
- 触发时机：实时触发，数据产生即转发
2. 输出
从目标系统获取数据并输出到平台，例如从外部系统拉取配置数据。
- 适用场景：配置同步、外部数据导入、数据回流
- 数据来源：外部 HTTP 接口、MQTT 主题、数据库表
- 触发时机：定时拉取或事件触发
三、选择目标类型并配置
1. HTTP 转发
通过 HTTP/HTTPS 协议将数据转发到指定的 Web 服务。
配置项说明：
- 请求方法：支持 GET、POST、PUT、DELETE 等方法
- 请求地址：目标服务的完整 URL 地址
- 请求头：自定义 HTTP Headers，如 Content-Type、Authorization 等
- 请求参数：URL 查询参数配置
- 请求体类型：支持 JSON、Form Data 等格式
- 请求体内容：具体的请求数据，支持变量替换
配置步骤：
- 选择【目标类型】为【HTTP】。
- 填写请求地址，例如：
https://api.example.com/device/data - 选择请求方法，通常使用 POST。
- 配置请求头，添加认证信息等。
- 配置请求体，定义数据格式和内容。
- 点击【保存】完成配置。
2. MQTT 转发
通过 MQTT 协议将数据发布到指定的 MQTT Broker。
配置项说明：
- 客户端ID：MQTT 客户端标识，需保证唯一性
- 服务器地址：MQTT Broker 的主机地址
- 服务器端口：MQTT 服务端口，默认 1883
- 用户名：MQTT 连接认证用户名（可选）
- 密码：MQTT 连接认证密码（可选）
- 主题：数据发布或订阅的 MQTT Topic
配置步骤：
- 选择【目标类型】为【MQTT】。
- 填写 MQTT Broker 的连接信息。
- 配置客户端 ID，建议使用有意义的标识。
- 填写认证信息（如果 Broker 需要）。
- 指定数据发布的主题。
- 点击【保存】完成配置。
3. Database 转发
将数据直接写入到关系型数据库。
配置项说明：
- 驱动类：数据库驱动类名，如
com.mysql.cj.jdbc.Driver - JDBC地址：数据库连接字符串
- 用户名：数据库连接用户名
- 密码：数据库连接密码
- 表名：数据写入的目标表名
配置步骤：
- 选择【目标类型】为【Database】。
- 填写数据库驱动类名。
- 配置 JDBC 连接地址，例如：
jdbc:mysql://localhost:3306/iot_db - 填写数据库认证信息。
- 指定目标表名。
- 点击【保存】完成配置。
四、设置优先级
- 在规则编辑页面，配置【优先级】字段。
- 当多个转发规则应用于同一产品时，按优先级顺序执行。
- 数值越大优先级越高，合理规划可实现数据的多级转发。
五、启用与监控
- 转发规则配置完成后，通过列表页面的开关启用规则。
- 启用后规则立即生效，开始转发数据。
- 可以通过平台日志查看转发执行情况。
- 监控转发成功率和失败原因，及时处理异常。
注意
- HTTP 转发时请确保目标服务地址可访问，避免网络隔离问题。
- MQTT 转发需要保证客户端 ID 的唯一性，避免连接冲突。
- Database 转发需要确保数据库表结构与数据字段匹配。
- 不同目标类型的配置互不兼容，切换目标类型会清空已有配置。
- 转发失败时数据可能丢失，建议配置重试机制或备用方案。