数据分发

数据分发功能可以将设备采集的数据自动推送到您的其他系统，实现数据互通和二次开发。

什么是数据分发

当设备上报数据时，研几云平台除了保存数据外，还可以同时将数据推送到您指定的目标系统。这样您就可以：

• 在自己的系统中使用设备数据
• 将数据存储到自己的数据库
• 对接第三方平台或应用
• 构建自定义的数据分析和展示

支持的分发类型

类型	说明	文档
HTTP Post	将数据推送到任意 HTTP 接口	HTTP Post 分发
MongoDB	将数据存储到 MongoDB 数据库	MongoDB 分发
MQTT	将数据发布到 MQTT 消息服务器	MQTT 分发
InfluxDB	将数据写入 InfluxDB 时序数据库	InfluxDB 分发
S3/OSS	将数据归档到对象存储	即将推出
AMQP	将数据发送到 RabbitMQ 等消息队列	即将推出

快速开始

准备工作

• 组织内至少有一台设备在上报数据
• 目标系统的连接信息（URL、密钥等）

创建分发配置

1. 登录 研几云平台
2. 进入您的组织，点击左侧菜单「数据分发」
3. 点击「新建配置」按钮
4. 填写配置信息：
   • 名称：便于识别的名称（可选）
   • 类型：选择分发目标类型
   • 优先级：数值越大越先执行
   • 目标配置：根据类型填写连接参数
5. 确保「启用」开关打开
6. 点击「保存」

管理配置

• 启用/暂停：点击开关快速切换状态
• 编辑：修改配置参数
• 删除：永久删除配置
• 统计：查看已发送数据条数

数据格式

所有分发类型使用统一的 JSON 数据格式：

[
  {
    "agri_id": "d-1000-abc-1-00",
    "t": 1709856000,
    "value": 25.5,
    "the_type": 100,
    "org_id": "your-org-slug"
  },
  {
    "agri_id": "d-1000-abc-1-01",
    "t": 1709856000,
    "value": 65.2,
    "the_type": 101,
    "org_id": "your-org-slug"
  }
]

字段	类型	说明
agri_id	string	因子唯一标识
t	integer	Unix 时间戳（秒）
value	number	因子数值
the_type	integer	因子类型编码
org_id	string	组织标识

多目标分发

您可以创建多个分发配置，将数据同时推送到多个目标：

• 配置 1：推送到业务系统（HTTP Post）
• 配置 2：备份到 MongoDB
• 配置 3：推送到 Grafana 监控（InfluxDB）

所有启用的配置都会收到数据，按优先级顺序执行。

常见问题

数据没有推送成功？

• 检查配置是否已启用
• 确认目标系统可访问
• 检查连接参数是否正确

推送有延迟吗？

数据分发是准实时的，通常在设备上报后几秒内完成推送。

推送失败会重试吗？

系统会自动重试失败的推送，但不保证 100% 送达。建议在接收端做好数据校验。

需要帮助？

如有问题，请联系我们：[email protected]