将 IoT 中心事件源添加到 Azure 时序见解环境

注意

2025 年 3 月之后,将不再支持时序见解 (TSI) 服务。 请考虑尽快将现有 TSI 环境迁移到备用解决方案。 有关弃用和迁移的详细信息,请访问我们的文档

本文介绍如何使用 Azure 门户将从 Azure IoT 中心读取数据的事件源添加到 Azure 时序见解环境。

注意

本文中的说明对于 Azure 时序见解第 1 代和 Azure 时序见解第 2 代环境都适用。

先决条件

  • 创建 Azure 时序见解环境
  • 使用 Azure 门户创建 IoT 中心
  • IoT 中心必须有正在发送进来的活动消息事件。
  • 在 IoT 中心创建专用使用者组,以供 Azure 时序见解环境使用。 每个 Azure 时序见解事件源都必须具有自己的专用使用者组,该组不与其他使用者共享。 如果多个读取器使用同一使用者组中的事件,则所有读取器都可能出现故障。 有关详细信息,请阅读 Azure IoT 中心开发人员指南

将使用者组添加到 IoT 中心

应用程序使用使用者组从 Azure IoT 中心提取数据。 若要可靠地从 IoT 中心读取数据,请提供一个专用的使用者组,仅供此 Azure 时序见解环境使用。

若要将新的使用者组添加到 IoT 中心,请执行以下操作:

  1. Azure 门户中,查找并打开 IoT 中心。

  2. 在“设置”下,选择“内置终结点”,然后选择“事件”终结点

    On the Build-in Endpoints page, select the Events button

  3. “使用者组”下,为使用者组输入唯一名称。 创建新的事件源时,请在 Azure 时序见解环境中使用此相同名称。

  4. 选择“保存” 。

添加新的事件源

  1. 登录到 Azure 门户

  2. 在左侧菜单中,选择“所有资源” 。 选择 Azure 时序见解环境。

  3. 在“设置”下,依次选择“事件源”、“添加”。

    Select Event Sources, and then select the Add button

  4. 在“新建事件源”窗格中,输入一个特定于此 Azure 时序见解环境的名称作为“事件源名称”。 例如,输入 event-stream

  5. 选择“IoT 中心”作为“源”

  6. 为“导入选项”选择一个值:

    • 在其中一个订阅上已有 IoT 中心时,请选择“从可用订阅使用 IoT 中心”。 此选项是最简单的方法。

      Select options in the New event source pane

    • 下表介绍的属性是“通过可用订阅使用 IoT 中心”选项所需的:

      New event source pane - Properties to set in the Use IoT Hub from available subscriptions option

      properties 说明
      订阅 所需的 iot 中心所属的订阅。
      IoT 中心名称 所选 iot 中心的名称。
      IoT 中心策略名称 选择共享访问策略。 可以在 IoT 中心设置选项卡上找到共享访问策略。每个共享访问策略具有名称、所设权限以及访问密钥。 事件源的共享访问策略必须具有服务连接权限
      IoT 中心策略密钥 密钥已预填充。
    • 如果 IoT 中心在订阅外部,或者你希望选择高级选项,请选择“手动提供 IoT 中心设置”

      下表介绍“手动提供 IoT 中心设置”所需的属性:

      属性 说明
      订阅 ID 所需的 iot 中心所属的订阅。
      资源组 在其中创建了此 IoT 中心的资源组名称。
      IoT 中心名称 IoT 中心的名称。 创建 IoT 中心时,为 IoT 中心输入了一个名称。
      IoT 中心策略名称 共享访问策略。 可以在 IoT 中心设置选项卡上创建共享访问策略。每个共享访问策略具有名称、所设权限以及访问密钥。 事件源的共享访问策略必须具有服务连接权限
      IoT 中心策略密钥 用于对 Azure 服务总线命名空间的访问权限进行身份验证的共享访问密钥。 在此处输入主密钥或辅助密钥。
    • 这两个选项共享以下配置选项:

      属性 描述
      IoT 中心使用者组 从 IoT 中心读取事件的使用者组。 强烈建议为事件源使用专用的使用者组。
      事件序列化格式 目前,JSON 是唯一可用的序列化格式。 事件消息必须采用此格式,否则将无法读取任何数据。
      时间戳属性名称 若要确定此值,需要了解发送到 IoT 中心的消息数据的消息格式。 此值是消息数据中你想要用作事件时间戳的特定事件属性的“名称”。 该值区分大小写。 如果留空,则事件源中的“事件排队时间”将用作事件时间戳。
  7. 添加已添加到 IoT 中心的专用 Azure 时序见解使用者组名称。

  8. 选择“创建”。

  9. 创建事件源以后,Azure 时序见解就会自动开始将数据流式传输到环境中。

后续步骤