NanoMQ 规则引擎配置详解：实现消息处理自动化

NanoMQ 规则引擎配置详解：实现消息处理自动化

【免费下载链接】nanomq An ultra-lightweight and blazing-fast Messaging broker/bus for IoT edge & SDV 项目地址: https://gitcode.com/gh_mirrors/nano/nanomq

什么是 NanoMQ 规则引擎

NanoMQ 规则引擎是 NanoMQ 消息中间件中的一项核心功能，它允许开发者通过配置 SQL 语句的方式，实现对 MQTT 消息的自动化处理。规则引擎可以看作是消息流中的智能过滤器与处理器，能够根据业务需求对消息进行筛选、转换、存储和转发。

规则引擎的核心应用场景

1. 复杂消息路由：根据消息内容将消息分发到不同的主题或服务
2. 数据持久化：将特定消息存储到数据库中进行长期保存
3. 系统集成：将 MQTT 消息与其他系统（如数据库、HTTP 服务等）集成
4. 自动化触发：当满足特定条件时自动执行预设操作

SQLite 数据持久化配置

SQLite 是一种轻量级的嵌入式数据库，非常适合在资源受限的环境中实现消息持久化。

配置结构解析

rules.sqlite = {
  path = "/tmp/sqlite_rule.db"          # 数据库文件存储路径
  rules = [
    {
      sql = "SELECT payload.x.y as y, payload.z as z FROM \"#\" WHERE y > 10 and z != 'str'"
      table = "broker"                  # 数据存储表名
    }
  ]
}

关键配置项说明

1. path：指定 SQLite 数据库文件的存储位置

   • 需确保 NanoMQ 有该路径的写入权限
   • 文件不存在时会自动创建

2. rules：定义处理规则数组

   • 每个规则对象包含 SQL 语句和目标表名
   • 支持同时配置多条规则处理不同类型的消息

SQL 语句编写要点

• 使用 SELECT 语句从消息中提取数据
• FROM 子句指定消息主题（使用 "#" 表示所有主题）
• WHERE 子句定义过滤条件
• 支持 JSON 路径表达式（如 payload.x.y）提取嵌套数据
• 使用 AS 为字段指定别名

MySQL 数据持久化配置

MySQL 是常用的关系型数据库，适合需要多应用共享数据的场景。

配置结构解析

rules.mysql.mysql_rule_db = {
  conn = {
    host = "localhost"                  # 数据库服务器地址
    username = "username"               # 登录用户名
    password = "password"               # 登录密码
    database = "db_name"                # 数据库名称
  }

  rules = [
    {
      table = "broker"                  # 目标表名
      sql = "SELECT payload.x.y as y, payload.z as z FROM \"#\" WHERE y > 10 and z != 'str'"
    }
  ]
}

关键配置项说明

1. conn：数据库连接配置

   • host：支持 IP 地址或域名
   • username/password：数据库认证信息
   • database：必须预先存在的数据库名称

2. rules：处理规则定义

   • table：指定数据写入的目标表
   • 表结构需与 SQL 查询结果匹配

注意事项

• 数据库表需要预先创建好
• 字段类型应与查询结果兼容
• 建议为频繁查询的字段建立索引
• 网络连接不稳定时需要考虑重试机制

消息重新发布配置

消息重新发布功能允许将处理后的消息转发到其他 MQTT 服务器或主题。

配置结构解析

rules.repub = {
  rules = [
    {
      server = "mqtt-tcp://localhost:1883"   # 目标服务器地址
      topic = "topic/repub1"                 # 目标主题
      proto_ver = 4                          # MQTT协议版本
      clientid = "repub_client1"             # 客户端标识
      sql = "SELECT payload.x.y as y, payload.z as z FROM \"#\" WHERE y > 10 and z != 'str'"
    }
  ]
}

关键配置项说明

1. server：目标 MQTT 服务器地址

   • 支持多种协议：mqtt-tcp://、mqtt-ssl://、ws://、wss://

2. topic：重新发布的目标主题

   • 可以是静态主题或基于消息内容动态生成

3. proto_ver：MQTT 协议版本

   • 3：MQTT v3.1
   • 4：MQTT v3.1.1（默认）
   • 5：MQTT v5

4. 客户端参数：

   • clientid：在目标服务器的唯一标识
   • keepalive：心跳间隔（默认60秒）
   • clean_start：是否清除会话（某些IoT平台要求设为true）

高级应用技巧

• 可以在 SQL 中使用字符串函数构造动态主题
• 结合 JSON 函数处理复杂的消息负载
• 使用多个重新发布规则实现消息分流

最佳实践建议

1. 性能考量：

   • 复杂的 SQL 条件会影响处理性能
   • 对高频主题考虑使用更精确的过滤条件

2. 错误处理：

   • 为数据库操作添加适当的重试逻辑
   • 监控规则执行状态

3. 安全建议：

   • 数据库密码等敏感信息应妥善保管
   • 限制 SQL 语句的复杂度防止注入攻击

4. 调试技巧：

   • 从简单规则开始逐步增加复杂度
   • 使用日志功能跟踪规则执行情况

通过合理配置 NanoMQ 规则引擎，开发者可以构建出高度灵活的消息处理流水线，满足各种物联网场景下的复杂需求。

【免费下载链接】nanomq An ultra-lightweight and blazing-fast Messaging broker/bus for IoT edge & SDV 项目地址: https://gitcode.com/gh_mirrors/nano/nanomq