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

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

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

如果资产具有测量值属性，您可以定义属性别名来将数据流映射到这些属性。您还可以设置属性别名，以便在提取或检索资产数据时轻松识别资产属性。

此过程要求您知道属性别名。

  • 如果使用网关从 OPC-UA 服务器提取数据，则属性别名是指向对象节点下面的变量的路径，以 / 开头。例如，如果变量的路径为 company/windfarm/3/turbine/7/temperature，则属性别名为 /company/windfarm/3/turbine/7/temperature。有关 OPC-UA 信息体系结构的详细信息，请参阅信息模型和地址间距映射中的OPC UA 在线参考.

    Notes

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

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

  • 如果您从其他源（例如使用 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 “Assets (资产)”页面屏幕截图，其中突出显示了资产层次结构。

  4. 选择 Edit。

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

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

  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 以禁用通知。 

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