将工业数据流映射到资产属性 - Amazon IoT SiteWise
设置属性别名（控制台）设置属性别名 (CLI)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将工业数据流映射到资产属性

您可以为任何类型的资产属性定义属性别名，以便在提取或检索资产数据时可以轻松识别资产属性。如果您的资产具有测量属性，则可以定义属性别名以将数据流映射到这些测量属性。

该过程需要您知道属性别名。

  • 如果您使用网关中的 OPC-UA 数据源从 OPC-UA 服务器提取数据，则您的属性别名是 Ob jec ts 节点下变量的路径，开头为/。例如，如果变量的路径为 company/windfarm/3/turbine/7/temperature，则属性别名为 /company/windfarm/3/turbine/7/temperature。有关 OPC-UA 信息架构的更多信息，请参阅 OPC UA 在线参考中的信息模型和地址间距映射。

    注意

    • 如果为 OPC-UA 源配置数据流前缀，则必须在来自该源的所有数据流的属性别名中包括该前缀。例如，如果使用 /RentonWA 作为前缀，则以前的别名为 /RentonWA/company/windfarm/3/turbine/7/temperature。

    • 属性别名最多可以包含 1000 字节。OPC-UA 变量的路径最多可以包含 4096 字节。目前，Amazon IoT SiteWise不支持从具有长路径的 OPC-UA 变量中提取数据。

  • 如果您在网关中使用 Modbus TCP 数据源从 Modbus 服务器提取数据，则您的属性别名是 Modbusregister set tag name。您可以使用此值将数据从该寄存器集发送到资产属性。

  • 如果您从其他源（例如使用 Amazon IoT 规则或 API）提取数据，则需要定义属性别名。您可以定义适用于您的设备配置的属性别名命名系统。例如，如果从 Amazon IoT 事物中提取数据，则可以在属性别名中包含事物名称以唯一地标识数据流。有关此示例的更多信息，请参阅从 Amazon IoT 事物中提取数据教程。

属性别名在区域和 Amazon 账户中必须是唯一的。如果您将属性别名设置为另一个资产属性中已经存在的别名，则 Amazon IoT SiteWise 将返回错误。

如果您有多个具有相同数据流路径的 OPC-UA 源，则可以向每个源的路径添加一个前缀以形成唯一别名。有关更多信息，请参阅配置数据源：

设置属性别名（控制台）

您可以使用 Amazon IoT SiteWise 控制台为资产属性设置别名。

设置属性别名（控制台）

  1. 导航到 Amazon IoT SiteWise 控制台。

  2. 在导航窗格中，选择 Assets (资产)。

  3. 选择要为其设置属性别名的资产。

    提示

    您可以选择箭头图标来展开资产层次结构以查找资产。

    Amazon IoT SiteWise“资产” 页面屏幕截图，突出显示了资产层次结构。

  4. 选择 Edit（编辑）。

  5. 查找要为其设置别名的属性，然后输入属性别名。

    Amazon IoT SiteWise“编辑资产” 页面屏幕截图，突出显示了属性别名。

  6. 选择 Save（保存）。

设置属性别名 (CLI)

您可以使用 Amazon Command Line Interface (Amazon CLI) 为资产属性设置别名。

您必须知道资产的 assetId 和属性的 propertyId 才能完成此过程。如果您创建了资产但不知道该资产assetId，请使用该ListAssets操作查看特定模型的所有资产。然后，使用该DescribeAsset操作查看资产的属性，包括属性 ID。

要将数据流映射到您的资产的属性，请使用UpdateAssetProperty操作。指定以下参数：

  • assetId— 资产的 ID。

  • propertyId— 资产属性的ID。

  • propertyAlias— 数据流到属性别名的路径。

  • propertyNotificationState— 属性值通知状态：ENABLED或DISABLED。在更新属性别名时指定属性的现有通知状态。您可以通过该DescribeAssetProperty操作检索现有通知状态。

    如果省略此参数，则新通知状态为 DISABLED。有关属性通知的更多信息，请参阅与其他 Amazon 服务交互。

设置属性别名 (CLI)

  1. 运行以下命令以检索属性的当前通知状态。将 asset-id 和 property-id 替换为资产属性的 ID。

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    此操作将按以下格式返回包含资产属性的详细信息的响应。属性通知状态位于 JSON 对象的 assetProperty.notification.state 中。

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "DISABLED | ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

  2. 运行以下命令以设置资产属性的别名。将 property-alias 替换为属性别名，将 notification-state 替换为通知状态，或者省略 --property-notification-state 以禁用通知。您可以选择使用新单位更新资产的单位，然后--property-unit。

    aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit