转换数据（转换） - Amazon IoT SiteWise
定义转换（控制台）定义转换 (CLI)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

转换数据（转换）

转换是将资产属性的数据点从一种形式映射到另一种形式的数学表达式。转换表达式由资产属性变量、字面值、运算符和函数组成。变换后的数据点持有 one-to-one与输入数据点的关系。Amazon IoT SiteWise每次当任何输入属性接收新数据点时，都会计算一个新的转换数据点。

例如，如果您的资产具有以摄氏度为单位的名为 Temperature_C 的温度测量流，您可以使用公式 Temperature_F = 9/5 * Temperature_C + 32 将每个数据点转换为华氏度。每次Amazon IoT SiteWise在中接收数据点Temperature_C测量流，相应的Temperature_F值会在几秒钟内计算出来，并作为Temperature_F财产。

如果您的转换包含多个变量，则较早到达的数据点会立即启动计算。举例来说，零件制造商使用变换来监控产品质量。制造商根据零件类型使用不同的标准，使用以下测量来表示流程：

  • Part_Number-标识部件类型的字符串。

  • Good_Count-如果零件符合标准，则增加一的整数。

  • Bad_Count-如果零件不符合标准，则增加一的整数。

制造商还创建了一个变换，Quality_Monitor，等于 if(eq(Part_Number, "BLT123") and (Bad_Count / (Good_Count + Bad_Count) > 0.1), "Caution", "Normal").

此转换监视为特定零件类型生产的不良部件的百分比。如果部件号为 BLT123 且不良部件的百分比超过 10% (0.1)，则返回变换"Caution". 否则，转换返回"Normal".

注意

  • 如果Part_Number在其他测量之前接收新的数据点，Quality_Monitor变换使用新的Part_Number值和最新的Good_Count和Bad_Count有效值。为了避免出现错误，请重置Good_Count和Bad_Count在下一次生产运行之前。

  • 使用指标如果您只想在所有变量都收到新数据点后才计算表达式。

定义转换（控制台）

在 Amazon IoT SiteWise 控制台中为资产模型定义转换时，请指定以下参数：

  • 名称-属性的属性的属性的属性的属性的属性的

  • 公式— 转换表达式。变换表达式不能使用聚合函数或时态函数。开始键入或按向下箭头键以打开自动完成功能。有关更多信息，请参阅 使用公式表达式。

    重要

    转换可以输入整型、双精度、布尔值或字符串类型的属性。布尔值转换为0(false) 和1（真）。

    转换必须输入一个或多个不是属性的属性和任意数量的特性属性。Amazon IoT SiteWise每次当不是属性的输入属性接收新数据点时，都会计算一个新的转换数据点。新属性值不会触发转换更新。

    公式表达式只能输出双精度值或字符串值。嵌套表达式可以输出其他数据类型，例如字符串，但整个公式的计算结果必须为数字或字符串。您可以使用日本 jp 函数，将字符串转换为数字。布尔值必须为 1 (true)。有关更多信息，请参阅 未定义值、无限值和溢出值。

  • 单位—（可选）属性的科学单位，例如毫米或摄氏度。

  • 数据类型— 转换的数据类型，可以是双精度要么字符串.

有关更多信息，请参阅 创建资产模型（控制台）。

例 转换定义

以下示例演示了将资产的温度测量数据从摄氏度转换为华氏度的转换属性。

Amazon IoT SiteWise “Create model (创建模型)”页面屏幕截图，其中突出显示了示例转换的参数。

例 包含三个变量的变换定义

以下示例演示了返回警告消息的转换属性 ("Caution")，如果超过 10% 的 BLT123 部件不符合标准。否则，它会返回信息消息 ("Normal")。

Amazon IoT SiteWise “Create model (创建模型)” 页面屏幕截图，其中突出显示了示例多变量转换的参数。

定义转换 (CLI)

使用 Amazon IoT SiteWise API 为资产模型定义转换时，请指定以下参数：

  • name-属性的属性的属性的属性的属性的属性的

  • dataType— 转换的数据类型，必须为DOUBLE要么STRING.

  • expression— 转换表达式。变换表达式不能使用聚合函数或时态函数。有关更多信息，请参阅 使用公式表达式。

  • variables— 定义要在表达式中使用的资产的其他属性的变量列表。每个变量结构包含一个在表达式中使用的简单名称，以及一个指定哪个属性与该变量关联的 value 结构。value 结构包含以下信息：

    • propertyId— 要从中输入值的属性的 ID。您可以使用属性的名称而不是其 ID。

    重要

    转换可以输入整型、双精度、布尔值或字符串类型的属性。布尔值转换为0(false) 和1（真）。

    转换必须输入一个或多个不是属性的属性和任意数量的特性属性。Amazon IoT SiteWise每次当不是属性的输入属性接收新数据点时，都会计算一个新的转换数据点。新属性值不会触发转换更新。

    公式表达式只能输出双精度值或字符串值。嵌套表达式可以输出其他数据类型，例如字符串，但整个公式的计算结果必须为数字或字符串。您可以使用日本 jp 函数，将字符串转换为数字。布尔值必须为 1 (true)。有关更多信息，请参阅 未定义值、无限值和溢出值。

  • unit—（可选）属性的科学单位，例如毫米或摄氏度。

例 转换定义

以下示例演示了将资产的温度测量数据从摄氏度转换为华氏度的转换属性。此对象是一个AssetModelProperty其中包含转换. 您可以将此对象指定为 CreateAssetModel 请求负载的一部分，以创建转换属性。有关更多信息，请参阅 创建资产模型 (CLI)。

{
  ...
  "assetModelProperties": [
    ...
    {
      "name": "Temperature F",
      "dataType": "DOUBLE",
      "type": {
        "transform": {
          "expression": "9/5 * temp_c + 32",
          "variables": [
            {
              "name": "temp_c",
              "value": {
                "propertyId": "Temperature C"
              }
            }
          ]
        }
      },
      "unit": "Fahrenheit"
    }
  ],
  ...
}

例 包含三个变量的变换定义

以下示例演示了返回警告消息的转换属性 ("Caution")，如果超过 10% 的 BLT123 部件不符合标准。否则，它会返回信息消息 ("Normal")。

{
  ...
  "assetModelProperties": [
    ...
  {
    "name": "Quality_Monitor",
    "dataType": "STRING",
    "type": {
        "transform": {
            "expression": "if(eq(Part_Number,"BLT123") and (Bad_Count / (Good_Count + Bad_Count) > 0.1), "Caution", "Normal")",
            "variables": [
                {
                    "name": "Part_Number",
                    "value": {
                        "propertyId": "Part Number"
                    }
                },
                {
                    "name": "Good_Count",
                    "value": {
                        "propertyId": "Good Count"
                    }
                },
                {
                    "name": "Bad_Count",
                    "value": {
                        "propertyId": "Bad Count"
                    }
                }
            ]
        }
    }
}
  ...
}