你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

注意

时序见解服务将于 2024 年 7 月 7 日停用。 请考虑尽快将现有环境迁移到备用解决方案。 有关弃用和迁移的详细信息,请访问我们的文档

本文介绍如何使用 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. 在“设置”下,选择“内置终结点”,然后选择“事件”终结点

    在“内置终结点”页上,选择“事件”按钮

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

  4. 选择“保存” 。

添加新的事件源

  1. 登录到 Azure 门户

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

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

    选择“事件源”,然后选择“添加”按钮

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

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

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

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

      在“新建事件源”窗格中选择选项

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

      “新建事件源”窗格 - 需要在“通过可用订阅使用 IoT 中心”选项中设置的属性

      属性 说明
      订阅 所需的 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 时序见解就会自动开始将数据流式传输到环境中。

后续步骤