将 MQTT 源添加到 Eventstream（预览版）

2025-04-07

本文介绍如何将 MQTT 源添加到 Eventstream。 

MQTT 是一种发布-订阅消息传输协议，专为受限环境而设计。由于其高效性、可扩展性和可靠性，它是 IoT 方案的首选通信标准。 Microsoft Fabric 事件流支持连接到 MQTT 代理，其中 MQTT 代理中的消息可引入到 Fabric Eventstream 中，并路由到 Fabric 中的各种目标。

注释

工作区容量的以下区域不支持此源：美国西部 3、瑞士西部。 

先决条件

在开始之前，必须完成以下先决条件：

使用“参与者”或更高权限访问 Fabric 高级工作区。 
收集用户名和密码以连接到 MQTT 代理。
确保 MQTT 代理可公开访问，不受防火墙或虚拟网络限制。

启动“选择数据源”向导

如果您尚未向事件流添加任何源，请选择“使用外部源”选项。

如果要向已发布的事件流添加源，请切换到“编辑”模式，在功能区中选择“添加源”，然后选择“外部源”。

在“选择数据源”页面上，搜索并选择“MQTT”磁贴上的“连接”。

配置 MQTT 连接器

在“连接”页上，选择“新建连接”。

如果存在与 MQTT 源的现有连接，请选择该现有连接。
在“连接设置”部分，
1. 对于“MQTT 代理 URL”，请输入 MQTT 代理的 URL，以开头。tcp://
  
  注释
  
  在 MQTT 代理与 Eventstream 之间，MQTT 源当前仅支持纯文本 MQTT 协议。
2. 对于“连接名称”，请输入与 MQTT 的连接的名称。
3. 输入 MQTT 代理的用户名和密码。
4. 选择连接。
现在，在向导的“连接”页上，必须输入单个主题名称。尚不支持多个主题。
对于版本，目前仅支持 MQTT V5。
然后，选择“下一步”
在“查看 + 连接”页上，查看设置，然后选择“添加”或“连接”。