向 eventstream 添加 Azure IoT 中心源

项目
11/19/2024

本文介绍如何向 eventstream 添加 Azure IoT 中心源。

注意

现在，创建事件流时，将会默认启用增强功能。如果你有使用标准功能创建的事件流，则这些事件流将继续正常工作。你仍然可以像往常一样编辑和使用它们。建议创建新的事件流来替换标准事件流，以便可以利用增强型事件流的其他功能和优势。

先决条件

开始之前，你必须满足以下先决条件：

使用参与者或更高权限在 Fabric 容量许可证模式（或）试用许可证模式下访问工作区。
需要具有适当的权限才能获得 IoT 中心的访问密钥。 IoT 中心必须可公开访问，并且不能位于防火墙后面或在虚拟网络中受到保护。
如果没有事件流，请创建一个事件流。

启动“选择数据源”向导

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

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

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

配置 Azure IoT 中心连接器

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

如果存在与 Azure IoT 中心的现有连接，请选择该现有连接，如下图所示，然后继续执行以下步骤中的配置数据格式的步骤。
在连接设置部分中，对于 IoT 中心，请指定 Azure IoT 中心的名称。
在“连接凭据”部分中，执行以下步骤：
1. 如果有现有连接，请从下拉列表中选择。如果没有，请确认为此选项选择了创建新连接。
2. 对于连接名称，请输入到 IoT 中心的连接的名称。
3. 对于身份验证方法，请确认已选择共享访问密钥。
4. 对于“共享访问密钥名称”，输入共享访问密钥的名称。
5. 对于“共享访问密钥”，输入共享访问密钥的值。
6. 在页面底部，选择“连接”。
  
  若要获取访问密钥名称和值，请执行以下步骤：
  1. 导航到 Azure 门户中 Azure IoT 中心的“IoT 中心”页。
  2. 在“IoT 中心”页面上，选择左侧导航菜单中“安全设置”下的“共享访问策略”。
  3. 从列表中选择一项策略名称。记下策略名称。
  4. 单击“主键”旁边的复制按钮。
现在，在向导的“连接”页上，对于“使用者组”，输入使用者组的名称。默认情况下，$Default 处于选中状态，这是 IoT 中心的默认使用者组。
对于数据格式，请选择要从 Azure IoT 中心获取的传入实时事件的数据格式。可从 JSON、Avro 和 CSV 数据格式中进行选择，然后选择“连接”。
在右侧的“流详细信息”部分中，选择“源名称”下的铅笔图标，然后为源输入一个名称。此步骤是可选的。
选择页面底部的“下一步”。
在“查看并创建”页上，查看设置，然后选择“添加”。

注意

一个事件流的源和目标的最大数量为 11。

查看更新的事件流

你会看到 Azure IoT 中心源已添加到“编辑”模式中画布上的事件流。若要实现新添加的 Azure IoT 中心，请选择功能区上的“发布”。
完成这些步骤后，Azure IoT 中心可用于“实时视图”中的可视化效果。选择关系图中的“IoT 中心”磁贴，查看类似于以下页面的页面。

有关受支持源的列表，请参阅在事件流中添加事件源

先决条件

开始之前，你必须满足以下先决条件：

使用参与者或更高权限在 Fabric 容量许可证模式（或）试用许可证模式下访问工作区。
需要具有适当的权限才能获得 IoT 中心的访问密钥。 IoT 中心必须可公开访问，并且不能位于防火墙后面或在虚拟网络中受到保护。

注意

一个事件流的源和目标的最大数量为 11。

将 Azure IoT 中心添加为源

按照以下步骤将 Azure IoT 中心添加为你的事件流源：

在事件流编辑器中，展开节点中的“新建源”下拉菜单，然后选择“Azure IoT 中心”。
在“Azure IoT 中心”配置窗格中，输入以下详细信息：
1. 源名称：输入你的 Azure IoT 中心的名称，例如 iothub-source。
2. 云连接：选择将你的 Azure IoT 中心链接到 Microsoft Fabric 的现有云连接。如果没有，请继续执行步骤 3 以创建新的云连接。
3. 数据格式。选择数据格式（AVRO、JSON 或 CSV），以将IoT 中心数据流式传输到事件流中。
4. 使用者组。从你的 Azure IoT 中心中选择一个使用者组，或将其留为 $Default。然后选择“添加”以完成 Azure IoT 中心配置。
5. 成功添加后，可以在编辑器中看到添加到事件流的 Azure IoT 中心源。
要为你的 Azure IoT 中心创建新的云连接，请执行以下步骤：
1. 从下拉菜单中选择“创建新连接”，填写 Azure IoT 中心的“连接设置”和“连接凭据”，然后选择“创建”。
2. IoT 中心。在 Azure 门户中输入 IoT 中心的名称。
3. 连接名称。输入新建云连接的名称，例如 iothub-connection。
4. “共享访问密钥名称”和“共享访问密钥”。输入 Azure IoT 中心的连接凭据。可在 Azure 门户中的“共享访问策略”下找到它。必须具有适当的权限，才能访问任何 IoT 中心终结点。
5. 返回到 Azure IoT 中心配置窗格，然后选择“刷新”以加载新的云连接。