# EMQ X Cloud 规则引擎保存数据到 MySQL

WARNING

该功能在基础版中不可用

在本文中我们将模拟温湿度数据并通过 MQTT 协议上报到 EMQ X Cloud,然后使用 EMQ X Cloud 规则引擎将数据转存到 MySQL。

在开始之前,您需要完成以下操作:

  • 已经在 EMQ X Cloud 上创建部署(EMQ X 集群)。
  • 对于专业版部署用户:请先完成 对等连接的创建,下文提到的 IP 均指资源的内网 IP。

# MySQL 配置

  1. MySQL 安装

    docker run -d --restart=always \
      --name mysql \
      -p 3306:3306 \
      -e MYSQL_ROOT_PASSWORD=public \
      mysql/mysql-server:5.7
    
    1
    2
    3
    4
    5
  2. 数据库创建

    docker exec -it mysql mysql -uroot -ppublic
    CREATE DATABASE emqx;
    USE emqx;
    
    1
    2
    3
  3. 温湿度表创建

    使用以下 SQL 语句将创建 temp_hum 表,该表将用于存放设备上报的温度和湿度数据。

    CREATE TABLE `temp_hum` (
      `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
      `up_timestamp` timestamp NULL DEFAULT NULL,
      `client_id` varchar(32) DEFAULT NULL,
      `temp` float unsigned DEFAULT NULL,
      `hum` float unsigned DEFAULT NULL,
      PRIMARY KEY (`id`),
      KEY `up_timestamp_client_id` (`up_timestamp`,`client_id`)
    ) ENGINE=InnoDB AUTO_INCREMENT=26 DEFAULT CHARSET=utf8mb4;
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
  4. 设置允许 EMQ X 集群 IP 段访问数据库(可选) 对于专业版部署,获取部署网段可以前往部署详情 → 查看对等连接信息,复制部署 VPC 网段。

    # 专业版
    GRANT ALL PRIVILEGES ON *.* TO root@'10.11.30.%' IDENTIFIED BY 'public' WITH GRANT OPTION;
    
    # 基础版
    GRANT ALL PRIVILEGES ON *.* TO root@'%' IDENTIFIED BY 'public' WITH GRANT OPTION;
    
    1
    2
    3
    4
    5
  5. 插入测试数据,并查看数据

    INSERT INTO temp_hum(up_timestamp, client_id, temp, hum) values (FROM_UNIXTIME(1603963414), 'temp_hum-001', 19.1, 55);
    
    select * from temp_hum;
    
    1
    2
    3

# EMQ X Cloud 规则引擎配置

  1. 资源创建

    点击左侧菜单栏规则引擎,找到资源面板,点击新建资源,下拉选择 MySQL 资源类型。填入刚才创建好的 mysql 数据库信息,并点击测试如果出现错误应及时检查数据库配置是否正确。

    资源创建

  2. 规则测试

    点击左侧左侧菜单栏规则引擎,找到规则面板,点击创建,然后输入如下规则匹配 SQL 语句。在下面规则中我们从 temp_hum/emqx 主题读取消息上报时间 up_timestamp、客户端 ID、消息体(Payload),并从消息体中分别读取温度和湿度。

    SELECT 
    
    timestamp as up_timestamp, clientid as client_id, payload.temp as temp, payload.hum as hum  
    
    FROM  
    
    "temp_hum/emqx"  
    
    1
    2
    3
    4
    5
    6
    7

    规则引擎

  3. 添加响应动作

    点击左下角添加动作,下拉选择 → 保存数据到 MySQL 选择第一步创建好的资源,并输入以下数据插入 SQL 模板。

    insert into temp_hum(up_timestamp, client_id, temp, hum) values (FROM_UNIXTIME(${up_timestamp}/1000), ${client_id}, ${temp}, ${hum}) 
    
    1

    规则引擎

  4. 点击创建规则,并返回规则列表

    规则列表

  5. 查看规则监控

    查看监控

# 测试

  1. 使用 MQTT X (opens new window) 模拟温湿度数据上报

    需要将 broker.emqx.io 替换成已创建的部署连接地址,并添加客户端认证信息

    • topic: temp_hum/emqx
    • payload:
      {
         "temp": "20.1",
         "hum": "57"
      }
      
      1
      2
      3
      4

    MQTTX

  2. 查看数据转存结果

    select * from temp_hum order by up_timestamp desc limit 10;
    
    1

    mysql