集成 PostgreSQL

TIP

支持 PostgreSQL 13 及以下版本

搭建 PostgreSQL 数据库，以 MacOS X 为例:

$ brew install postgresql
$ brew services start postgresql

## 使用用户名 root 创建名为 'mqtt' 的数据库
$ createdb -U root mqtt

$ psql -U root mqtt

mqtt=> \dn;
List of schemas
Name  | Owner
--------+-------
public | shawn
(1 row)

初始化 PgSQL 表:

$ psql -U root mqtt

创建 t_mqtt_msg 表:

CREATE TABLE t_mqtt_msg (
    id SERIAL primary key,
    msgid character varying(64),
    sender character varying(64),
    topic character varying(255),
    qos integer,
    payload text,
    arrived timestamp without time zone
);

创建规则:

打开 EMQX Dashboard，选择左侧的 “规则” 选项卡。

填写规则 SQL:

SELECT * FROM "t/#"

关联动作:

在 “响应动作” 界面选择 “添加”，然后在 “动作” 下拉框里选择 “保存数据到 PostgreSQL”。

填写动作参数:

“保存数据到 PostgreSQL” 动作需要两个参数：

1). 关联资源的 ID。现在资源下拉框为空，可以点击右上角的 “新建资源” 来创建一个 PostgreSQL 资源:

选择 “PostgreSQL 资源”。

填写资源配置:

数据库名填写 “mqtt”，用户名填写 “root”，其他配置保持默认值，然后点击 “测试连接” 按钮，确保连接测试成功。

最后点击 “新建” 按钮。

返回响应动作界面，点击 “确定”。

2).SQL 模板。这个例子里我们向 PostgreSQL 插入一条数据，SQL ​ 模板为:

insert into t_mqtt_msg(msgid, topic, qos, payload, arrived) values (${id}, ${topic}, ${qos}, ${payload}, to_timestamp(${timestamp}::double precision /1000))

插入数据之前，SQL 模板里的 ${id} 占位符会被替换为相应的值。

如果占位符变量未定义，您可以使用未定义值作为 NULL 插入选项来规定规则引擎的行为：

• false （默认）：规则引擎可能会插入 undefined 字符串到数据库中。
• true：当变量未定义时，规则引擎使用 NULL 写入到数据库。

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

规则已经创建完成，现在发一条数据:

Topic: "t/1"
QoS: 0
Payload: "hello1"

然后检查 PostgreSQL 表，新的 record 是否添加成功:

在规则列表里，可以看到刚才创建的规则的命中次数已经增加了 1: