用北向连接器把数据送出去

三步把平台点位以 Sparkplug B 报文发布到客户自己的 MQTT Broker,或以 SSE 订阅 API 交付第三方系统,并在发布监控里盯住吞吐与断连。

  • 进阶
  • 动手约 20 分钟
  • 阅读 2 分钟
  • 更新于 2026-11-09

视频教程 · 灵犀·Studio 从入门到精通 · 第 12 集 3:49

北向集成、权限与运维升级

你将完成

读完本篇你将完成:

  • 创建一个北向连接器并连上客户 MQTT Broker;
  • 在映射配置器里勾选点位、生成 UNS 名称;
  • 建一个订阅应用给第三方系统领凭证消费 SSE 流;
  • 用发布监控确认数据真的出去了。

开始之前

  • 平台里已有设备与测点(内置仿真设备即可);
  • 拿到客户 MQTT Broker 的地址与账号(本文用本机测试 Broker 演示)。

出站链路全景#

北向数据出站链路平台点位经映射配置器注册到北向连接器,连接器以 Sparkplug B 报文发布到客户自己的 MQTT Broker 供 MES、BI 等系统订阅;第三方系统也可以在订阅应用领取凭证,通过 SSE 订阅 API 直接消费数据流。平台点位设备 · 测点已采集的实时值灌装产线反应釜AGV 调度能源计量1映射配置器点位 → UNS 名称可整设备勾选批量注册2北向连接器Sparkplug B 报文NBIRTH · NDATA · NDEATH值变化 / 死区 / 周期上报断线自动重连重发布客户 MQTT Broker客户自备,平台只做客户端上层系统MESERPBI · 云订阅3订阅应用 · SSEApp Key 换 token 消费数据流两条出站通道互不依赖:MQTT 出站面向客户消息骨干,SSE 订阅面向轻量第三方系统① 映射决定「发什么」 ② 连接器决定「发到哪、怎么发」 ③ 订阅应用决定「谁在直接拉数据」
图 1 北向出站:映射决定发什么,连接器决定发到哪,订阅应用面向轻量直连

平台提供两条互不依赖的出站通道:MQTT 出站(Sparkplug B 标准报文,面向客户消息骨干)与 SSE 订阅(HTTP 流式接口,面向轻量第三方系统)。

创建连接器#

菜单北向数据 → 北向连接器。列表页顶部有三步引导,点每一步直达对应功能:

北向连接器首页的三步引导:创建连接器 → 勾选点位发布 → 启用并交付消费
  1. 1建连接器
  2. 2勾选点位

点新建连接器:

新建连接器弹窗(上半部分):名称与类型、客户 Broker 地址与账号
  1. 1填写名称
  2. 2填 Broker
  3. 3① 基本信息
字段说明示例 / 默认值
名称连接器显示名MES 数据对接
类型当前为 Sparkplug B(MQTT 出站)—
Broker 地址客户自己的 MQTT Brokertcp://broker.example.com:1883,TLS 用 ssl://…:8883
group_idSparkplug 主题顶层命名空间,小写字母 / 数字 / 下划线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 不可达会显示离线与最后错误,恢复后自动重连。

连接器列表:运行状态、目标 Broker、已发布点位数与今日运行指标
  1. 1连接器行
  2. 2目标 Broker 与已发布点位数
  3. 3配映射

勾选要发布的点位#

点行内映射进入映射配置器。左边搜索测点,按设备分组勾选;勾组头等于整设备发布。勾选后右侧自动生成 UNS 指标名与别名(alias),点保存批量注册并触发一次 REBIRTH。

映射配置器:搜索、按设备整组勾选,metric 名自动生成可改
  1. 1搜索测点
  2. 2已选计数与清空入口
  3. 3整组勾选

每条映射可单独覆盖上报模式与死区:开关量保持 on-change,模拟量改 deadband 或 period,避免无意义的刷屏帧。

交付:MQTT 或 SSE#

  • MQTT 消费方:在客户侧订阅 spBv1.0/{group_id}/# 即可拿到 NBIRTH / NDATA 数据报文;
  • SSE 消费方:到北向数据 → 订阅应用点新建应用,填写名称、订阅范围(如 mes.#)、限流与日配额,创建后领取一次 App Key / App Secret。
订阅应用:一应用一套凭证,限额与用量一目了然
  1. 1订阅应用
  2. 2订阅范围 / 今日用量 / 最近连接一目了然

第三方用凭证签名换短期 token,再订阅 SSE 流(首屏快照 + 增量帧),示例命令见开放 API。

盯住发布#

菜单北向数据 → 发布监控:连接器状态卡显示在线状态、吞吐与最近发布时间,下方是发布吞吐曲线与事件流。帧率掉零、反复重连都会第一时间出现在这里;行内REBIRTH 可手工重发出生证书。

发布监控:连接器状态卡与吞吐、事件流
  1. 1连接器状态卡:在线状态、吞吐与最近发布时间

预期结果

用任意 MQTT 客户端订阅 spBv1.0/{group_id}/# 能看到 NBIRTH 与随数据变化的 NDATA 帧;发布监控里今日发布帧数持续增长,连接器状态在线。

常见问题#

状态一直「离线」并显示 not Authorized#

Broker 账号或密码不对。编辑连接器改用户名 / 密码(保存不会清空已有映射),改完停启一次立即重连。

数据太多把 Broker 打满#

把模拟量映射改成 deadband(变化超阈值才发)或 period(低频周期快照);连接器默认批量 200 条、200 ms 攒批发送,高级参数里可调。

换了 Broker 地址要重新配映射吗#

不用。映射挂在连接器上,改地址、换账号都不影响已注册点位;重连后会自动 REBIRTH。

下一步#

这篇文档对你有帮助吗?