本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将工业数据流映射到资产属性
如果资产具有测量值属性,您可以定义属性别名来将数据流映射到这些属性。您还可以设置属性别名,以便在提取或检索资产数据时轻松识别资产属性。
此过程要求您知道属性别名。
-
如果使用网关从 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 字节。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 控制台为资产属性设置别名。
设置属性别名(控制台)
设置属性别名 (CLI)
您可以使用 Amazon Command Line Interface (Amazon CLI) 为资产属性设置别名。
您必须知道资产的 assetId
和属性的 propertyId
才能完成此过程。如果你创建了资产但不知道assetId
,使用ListAssets操作以查看特定模型的所有资产。然后,使用DescribeAsset操作以查看资产的属性,包括属性 ID。
要将数据流映射到资产的属性,请使用UpdateAsset属性operation. 指定以下参数:
-
assetId
— 资产的 ID。 -
propertyId
— 资产属性的 ID。 -
propertyAlias
— 数据流到属性别名的路径。 -
propertyNotificationState
— 属性值通知状态:ENABLED
要么DISABLED
. 在更新属性别名时指定属性的现有通知状态。您可以使用DescribeAsset属性operation.如果省略此参数,则新通知状态为
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
以禁用通知。aws iotsitewise update-asset-property \ --asset-id
asset-id
\ --property-idproperty-id
\ --property-aliasproperty-alias
\ --property-notification-statenotification-state