提高数据集成稳定性：EMQX Platform 端到端规则调试指南

自 5.7.0 版本起，EMQX 支持了 SQL 调试，并支持在数据集成全流程中进行规则调试，使用户能够在开发阶段就全面验证和优化规则，确保它们在生产环境中的稳定高效运行。

点击此处下载 EMQX 最新版本：https://www.emqx.com/zh/try?tab=self-managed

本文将为您提供 EMQX 数据集成规则的调试指南，通过调试步骤的详细介绍，帮助您充分了解并利用这一强大的功能。

EMQX 规则引擎介绍

EMQX 规则引擎是一个基于 SQL 的数据处理组件，借助数据集成，用户无需编写代码即可完成物联网数据的提取、过滤、转换、存储和处理任务。

规则引擎的工作原理：

• 数据源：通过 SQL 中的 FROM 子句指定。
• 数据处理：通过 SQL 语句和函数进行描述。
• 结果输出：通过动作来处理输出结果，比如将其存储到数据库或重新发布到 MQTT 主题中。

关键动作：

• 将消息重新发布到 MQTT 主题
• 输出到控制台
• 发送到外部数据系统，如 Kafka、MySQL、PostgreSQL 等。

本指南将重点介绍如何在 EMQX 数据集成中调试这些规则，以确保它们在生产环境中能够按预期工作。

为什么需要规则测试？

目前，在 EMQX 中创建直接可用的规则可能会面临一些挑战，主要体现在以下几个限制：

• 仅限于 SQL 测试：当前只能通过模拟数据输入来测试 SQL，这虽然有助于用户调整 SQL 语法以实现目标，但无法全面验证规则的整体效果。
• 动作测试：动作只能在 Sink 资源的生产环境中观察，限制了提前充分测试和验证动作的可能性。每次调整都需要切换不同的系统来检查结果，增加了操作的复杂性。
• 模拟数据限制：模拟数据通常有限，难以全面反映 MQTT 属性和事件的真实情况，导致测试结果可能无法覆盖所有用户场景。

通过仪表板提供全面反馈并跟踪整个数据集成生命周期中的日志，规则测试可以有效解决上述限制，帮助用户更好地识别和解决问题。规则测试的主要优势包括：

• 端到端验证：可以使用真实的数据源和动作进行测试，确保从输入到输出的每个数据流环节都按预期运行。
• 更好的问题检测：在开发和规则编辑阶段，用户界面提供了直观的工具，帮助快速识别和解决潜在问题，从而减少生产环境中的故障发生率。
• 提高开发效率：测试功能能够缩短开发和测试周期，使规则的部署更加高效。
• 保障系统稳定性：通过预先测试和验证规则，降低了生产环境中出现未预见问题的风险。

规则测试功能使用教程

安装 EMQX Enterprise

推荐下载：EMQX Enterprise - 此版本提供丰富的数据集成功能，支持 Kafka、RabbitMQ、MySQL、PostgreSQL、InfluxDB、TimescaleDB 等常用的关系型数据库、时序数据库和流处理中间件。

您也可以使用以下 Docker 命令安装：

docker run -d --name emqx-enterprise -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx-enterprise:5.7.1

安装完成后，在浏览器中打开 <http://<your-host-address>>:18083，输入默认的用户名和密码即可登录 Dashboard。

登录后，依次点击数据集成 → 规则 → 创建，进入规则引擎创建页面。页面的上半部分用于配置 SQL、数据源和 Sink，而下半部分则是进行规则测试的区域。接下来，我们将通过两个简单的例子演示如何创建和启用规则测试。

创建规则

在完成 EMQX 安装后，我们通过一个具体示例来展示规则引擎的使用。该场景模拟车辆数据上报，并在车速超过 120 公里/小时时，将相关数据（包括速度和地理位置）发布到 HTTP 服务。车辆的 ID 和 MQTT 连接信息将存储在 PostgreSQL 数据库中。

• 模拟 MQTT 有效载荷进行测试：首先，模拟一条 MQTT 有效载荷来模拟车