在公式表达式中使用变量 - Amazon IoT SiteWise
使用变量引用属性
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

在公式表达式中使用变量

变量表示公式表达式中的 Amazon IoT SiteWise 资产属性。使用变量在表达式中输入来自其他资产属性的值，以便您可以处理来自常量属性（属性）、原始数据流（测量）和其他公式属性的数据。

变量可以表示来自同一资产模型或关联子资产模型的资产属性。只有指标公式才能输入子资产模型中的变量。

您可以在控制台和 API 中使用不同的名称来识别变量。

  • Amazon IoT SiteWise 控制台-在表达式中使用资产属性名称作为变量。

  • Amazon IoT SiteWise API (Amazon CLI, Amazon SDK)-使用ExpressionVariable结构定义变量，该结构需要变量名和对资产属性的引用。变量名称可包含大小写字母、数字和下划线。然后，使用变量名在表达式中引用资产属性。

变量名称区分大小写。

有关更多信息，请参阅定义转换和定义指标。

使用变量引用属性

变量的值定义了它所引用的属性。 Amazon IoT SiteWise 提供了不同的方法来执行此操作。

  • 按属性 ID：您可以指定属性的唯一 ID (UUID) 来对其进行识别。

  • 按名称：如果该属性属于同一资产模型，则可以在属性 ID 字段中指定其名称。

  • 按路径：变量值可以通过其路径来引用属性。有关更多信息，请参阅 使用路径引用自定义复合模型属性。

注意

Amazon IoT SiteWise 控制台不支持变量。它们由 Amazon IoT SiteWise API（包括 Amazon Command Line Interface Amazon CLI）和 Amazon 软件开发工具包使用。

您在响应中收到的变量 Amazon IoT SiteWise 包含有关该值的完整信息，包括 ID 和路径。

但是，当您将变量传递到时 Amazon IoT SiteWise （例如，在 “创建” 或 “更新” 调用中），您只需要指定其中一个即可。例如，如果您指定路径，则无需提供 ID。