用北向连接器把数据送出去
三步把平台点位以 Sparkplug B 报文发布到客户自己的 MQTT Broker,或以 SSE 订阅 API 交付第三方系统,并在发布监控里盯住吞吐与断连。
视频教程 · 灵犀·Studio 从入门到精通 · 第 12 集 3:49
北向集成、权限与运维升级
你将完成
读完本篇你将完成:
- 创建一个北向连接器并连上客户 MQTT Broker;
- 在映射配置器里勾选点位、生成 UNS 名称;
- 建一个订阅应用给第三方系统领凭证消费 SSE 流;
- 用发布监控确认数据真的出去了。
开始之前
- 平台里已有设备与测点(内置仿真设备即可);
- 拿到客户 MQTT Broker 的地址与账号(本文用本机测试 Broker 演示)。
出站链路全景#
平台提供两条互不依赖的出站通道:MQTT 出站(Sparkplug B 标准报文,面向客户消息骨干)与 SSE 订阅(HTTP 流式接口,面向轻量第三方系统)。
创建连接器#
菜单北向数据 → 北向连接器。列表页顶部有三步引导,点每一步直达对应功能:
- 1建连接器
- 2勾选点位
点新建连接器:
- 1填写名称
- 2填 Broker
- 3① 基本信息
| 字段 | 说明 | 示例 / 默认值 |
|---|---|---|
| 名称 | 连接器显示名 | MES 数据对接 |
| 类型 | 当前为 Sparkplug B(MQTT 出站) | — |
| Broker 地址 | 客户自己的 MQTT Broker | tcp://broker.example.com:1883,TLS 用 ssl://…:8883 |
| group_id | Sparkplug 主题顶层命名空间,小写字母 / 数字 / 下划线 | gz-factory-1 |
| edge_node_id | 网关标识,留空自动取网关安装标识 | — |
| 默认上报模式 | 值变化即发布(on-change)、死区(deadband)、周期(period) | on-change |
| 创建后立即启用 | 启用后自动连接并发布 NBIRTH | 开 |
提示
group_id 加 edge_node_id 构成主题前缀 spBv1.0/{group_id}/…/{edge_node_id}。上线时连接器先发 NBIRTH(出生证书,含全部点位元数据),断线时以遗嘱发 NDEATH,重连后自动补发。
保存后列表出现这条连接器,状态从连接中变为在线;Broker 不可达会显示离线与最后错误,恢复后自动重连。
- 1连接器行
- 2目标 Broker 与已发布点位数
- 3配映射
勾选要发布的点位#
点行内映射进入映射配置器。左边搜索测点,按设备分组勾选;勾组头等于整设备发布。勾选后右侧自动生成 UNS 指标名与别名(alias),点保存批量注册并触发一次 REBIRTH。
- 1搜索测点
- 2已选计数与清空入口
- 3整组勾选
每条映射可单独覆盖上报模式与死区:开关量保持 on-change,模拟量改 deadband 或 period,避免无意义的刷屏帧。
交付:MQTT 或 SSE#
- MQTT 消费方:在客户侧订阅
spBv1.0/{group_id}/#即可拿到 NBIRTH / NDATA 数据报文; - SSE 消费方:到北向数据 → 订阅应用点新建应用,填写名称、订阅范围(如
mes.#)、限流与日配额,创建后领取一次 App Key / App Secret。
- 1订阅应用
- 2订阅范围 / 今日用量 / 最近连接一目了然
第三方用凭证签名换短期 token,再订阅 SSE 流(首屏快照 + 增量帧),示例命令见开放 API。
盯住发布#
菜单北向数据 → 发布监控:连接器状态卡显示在线状态、吞吐与最近发布时间,下方是发布吞吐曲线与事件流。帧率掉零、反复重连都会第一时间出现在这里;行内REBIRTH 可手工重发出生证书。
- 1连接器状态卡:在线状态、吞吐与最近发布时间
预期结果
用任意 MQTT 客户端订阅 spBv1.0/{group_id}/# 能看到 NBIRTH 与随数据变化的 NDATA 帧;发布监控里今日发布帧数持续增长,连接器状态在线。
常见问题#
状态一直「离线」并显示 not Authorized#
Broker 账号或密码不对。编辑连接器改用户名 / 密码(保存不会清空已有映射),改完停启一次立即重连。
数据太多把 Broker 打满#
把模拟量映射改成 deadband(变化超阈值才发)或 period(低频周期快照);连接器默认批量 200 条、200 ms 攒批发送,高级参数里可调。
换了 Broker 地址要重新配映射吗#
不用。映射挂在连接器上,改地址、换账号都不影响已注册点位;重连后会自动 REBIRTH。
下一步#
- 开放 API 与访问令牌 SSE 订阅的完整调用方式与签名示例。
- 配置采集点位 先把要发布的点位采稳。
- 数据存储与保留策略 数据落地与查询侧的管理入口。
这篇文档对你有帮助吗?