离线消息保存到 MySQL

搭建 MySQL 数据库,并设置用户名密码为 root/public,以 MacOS X 为例:

  1. $ brew install mysql
  2. $ brew services start mysql
  3. $ mysql -u root -h localhost -p
  4. ALTER USER 'root'@'localhost' IDENTIFIED BY 'public';

初始化 MySQL 数据库:

  1. $ mysql -u root -h localhost -ppublic
  2. create database mqtt;

创建 mqtt_msg 表:

  1. DROP TABLE IF EXISTS `mqtt_msg`;
  2. CREATE TABLE `mqtt_msg` (
  3. `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  4. `msgid` varchar(64) DEFAULT NULL,
  5. `topic` varchar(180) NOT NULL,
  6. `sender` varchar(64) DEFAULT NULL,
  7. `qos` tinyint(1) NOT NULL DEFAULT '0',
  8. `retain` tinyint(1) DEFAULT NULL,
  9. `payload` blob,
  10. `arrived` datetime NOT NULL,
  11. PRIMARY KEY (`id`),
  12. INDEX topic_index(`id`, `topic`)
  13. ) ENGINE=InnoDB DEFAULT CHARSET=utf8MB4;
  14. CREATE TABLE `mqtt_acked` (
  15. `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  16. `clientid` varchar(64) DEFAULT NULL,
  17. `topic` varchar(180) DEFAULT NULL,
  18. `mid` int(11) unsigned DEFAULT NULL,
  19. `created` timestamp NULL DEFAULT NULL,
  20. PRIMARY KEY (`id`),
  21. UNIQUE KEY `mqtt_acked_key` (`clientid`,`topic`),
  22. INDEX topic_index(`id`, `topic`)
  23. ) ENGINE=InnoDB DEFAULT CHARSET=utf8MB4;

WARNING

消息表结构不能修改,请使用上面SQL语句创建

创建规则:

打开 EMQ X Dashboard离线消息保存到 MySQL - 图1 (opens new window),选择左侧的“规则”选项卡。

然后填写规则 SQL:

FROM说明

t/#: 发布者发布消息触发保存离线消息到MySQL

$events/session_subscribed: 订阅者订阅主题触发获取离线消息

$events/message_acked: 订阅者回复消息ACK后触发删除已经被接收的离线消息

  1. SELECT * FROM "t/#", "$events/session_subscribed", "$events/message_acked" WHERE topic =~ 't/#'

离线消息保存到 MySQL - 图2

关联动作:

在“响应动作”界面选择“添加动作”,然后在“动作”下拉框里选择“离线消息保存到 MySQL”。

离线消息保存到 MySQL - 图3

现在资源下拉框为空,可以点击右上角的 “新建” 来创建一个 MySQL 资源:

离线消息保存到 MySQL - 图4

弹出一个“创建资源”对话框

离线消息保存到 MySQL - 图5

填写资源配置:

填写真实的 MySQL 服务器地址,其他配置填写相应的值,然后点击 “测试连接” 按钮,确保连接测试成功。

最后点击 “确定” 按钮。

离线消息保存到 MySQL - 图6

返回响应动作界面,点击 “确认”。

离线消息保存到 MySQL - 图7

返回规则创建界面,点击 “创建”。

离线消息保存到 MySQL - 图8

规则已经创建完成,通过 Dashboard 的 WebSocket 客户端发一条数据**(发布消息的QoS必须大于0)**:

离线消息保存到 MySQL - 图9

消息发送后,通过 mysql 查看到消息被保存到 MySQL 里面:

离线消息保存到 MySQL - 图10

使用另外一个客户端,订阅主题 “t/1” (订阅主题的QoS必须大于0,否则消息会被重复接收):

离线消息保存到 MySQL - 图11

订阅后马上接收到了保存到 MySQL 里面的离线消息:

离线消息保存到 MySQL - 图12

离线消息被接收后会在 MySQL 中删除:

离线消息保存到 MySQL - 图13