本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将工业数据流映射到资产属性
您可以为任何类型的资产属性定义属性别名,以便在摄取或检索资产数据时可以轻松识别资产属性。如果您的资产具有测量属性,则可以定义属性别名以将数据流映射到这些测量属性。
该过程需要您知道您的财产别名。
-
如果您使用网关中的 OPC-UA 数据源从 OPC-UA 服务器提取数据,则您的属性别名是对象节点下变量的路径,开头为
/
。例如,如果变量的路径为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 字节。OC-UA 变量路径最多可以包含 4096 字节。目前,Amazon IoT SiteWise不支持从具有长路径的 OPC-UA 变量中提取数据。
-
-
如果您使用网关中的 Modbus TCP 数据源从 Modbus 服务器提取数据,则您的属性别名是 Modbus
register set tag name
。您可以使用此值将数据从此寄存器集发送到资产属性。 -
如果您从其他源(例如使用 Amazon IoT 规则或 API)提取数据,则需要定义属性别名。您可以定义适用于您的设备配置的属性别名命名系统。例如,如果从 Amazon IoT 事物中提取数据,则可以在属性别名中包含事物名称以唯一地标识数据流。有关此示例的更多信息,请参阅从 Amazon IoT 事物中提取数据教程。
属性别名在区域和 Amazon 账户中必须是唯一的。如果您将属性别名设置为另一个资产属性中已经存在的别名,则 Amazon IoT SiteWise 将返回错误。
如果您有多个具有相同数据流路径的 OPC-UA 源,则可以向每个源的路径添加一个前缀以形成唯一别名。有关更多信息,请参阅配置数据源:
设置属性别名(控制台)
您可以使用 Amazon IoT SiteWise 控制台为资产属性设置别名。
设置属性别名(控制台)
设置属性别名 (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)
-
运行以下命令以检索属性的当前通知状态。将
asset-id
和property-id
替换为资产属性的 ID。aws iotsitewise describe-asset-property \ --asset-id
asset-id
\ --property-idproperty-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": {} } } } -
运行以下命令以设置资产属性的别名。将
property-alias
替换为属性别名,将notification-state
替换为通知状态,或者省略--property-notification-state
以禁用通知。您可以选择使用新单位和更新资产的单位
--property-unit
。aws iotsitewise update-asset-property \ --asset-id
asset-id
\ --property-idproperty-id
\ --property-aliasproperty-alias
\ --property-notification-statenotification-state
\ --property-unitunit