了解接口与资产模型的关系 - AWS IoT SiteWise
标准化现有资产模型层次关系接口指标和汇总计算

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

了解接口与资产模型的关系

接口和资产模型在互补关系中协同工作：

接口与资产模型
方面 接口 资产模型
用途 定义标准并应用一致性 表示实物或逻辑资产
资产创建 无法直接创建资产 用于创建资产
属性 定义必须在模型中实现的标准属性 可以具有界面应用和独特的特性
Metrics 定义标准计算 实现接口指标并可以有其他指标
层次结构 为汇总指标定义数据计算层次关系 为资产关联定义物理层次关系

将接口应用于资产模型时：

  • 资产模型必须映射界面中定义的所有属性。

  • 属性映射定义了接口属性与资产模型属性的对应方式。

  • 映射的资产模型属性必须与其对应的接口属性保持同步，并且不能以可能导致两者之间不一致的方式进行修改。

  • 未映射的界面属性会在资产模型中自动创建。

  • 除了界面中定义的属性之外，资产模型还可以具有其他属性。

  • 资产模型实现了接口指标。对接口指标的更改会传播到使用该接口的所有资产模型。

  • 接口层次结构用于计算汇总指标。资产模型层次结构可以独立定义，服务将在计算汇总指标时自动映射它们。

这种关系确保了标准化，同时又提供了代表不同设备类型所需的灵活性。

标准化现有资产模型

虽然接口在从头开始设计新的资产模型时非常有价值，但在标准化可能随着时间的推移而独立演变的现有资产模型方面，它们同样强大。

在使用现有资产模型时，您可以应用接口来标准化指标和属性：

  1. 确定现有资产模型中的常见指标和属性

  2. 创建定义这些标准属性和指标的接口

  3. 使用属性映射将接口应用于您现有的资产模型

  4. 使用汇总指标汇总资产层次结构中的数据

例如，如果现有的 CNC 机床资产模型具有不同的属性名称但数据相似，例如temp_celsius、temperature_c、machine_temp)，则可以：

  1. 使用标准化Temperature-in-C属性创建 CNC-INTERFACE

  2. 将此接口应用于每个 CNC 资产模型，将现有温度属性映射到接口的Temperature-in-C属性

  3. 在界面中定义汇总指标，用于计算所有计算机的统计数据（例如平均温度）

这种方法允许您维护现有的资产模型，同时获得标准化和简化的指标计算的好处。

层次关系

接口层次结构

定义跨不同接口计算和聚合数据的关系。例如，在出厂设置中，接口层次结构可以连接不同级别的温度监控接口来计算平均温度。例如：机器、生产线和设施。当您定义汇总指标时AverageTemperature，接口层次结构决定了该指标如何将数据从较低级别聚合到更高级别。

资产模型层次结构

代表您的资产的实际物理或逻辑结构。例如，数控机床资产模型可能是生产线资产模型的一部分，而生产线资产模型又属于工厂资产模型。这种层次结构反映了现实世界的关系，有助于以与资产的实际安排或业务结构相匹配的方式组织资产。与接口层次结构结合使用时，资产模型层次结构可帮助系统了解哪些资产应包含在汇总计算中。

这两种层次结构类型协同工作：接口层次结构定义如何计算聚合指标，而资产模型层次结构则定义应在这些计算中包括哪些特定资产。

接口指标和汇总计算

接口擅长定义可应用于不同资产模型的标准化指标。这对于汇总来自多个资产的数据的汇总指标特别有价值。

当您在界面中定义指标时，它们会自动应用于实现该接口的所有资产模型。这些指标可以引用界面中定义的属性，使用聚合函数计算跨资产的统计数据，并确保所有实现的资产模型的计算保持一致。例如，您可以在计算运行时间与总时间的比率的接口中定义可用性指标：

{
  "name": "Availability",
  "dataType": "DOUBLE",
  "type": {
    "metric": {
      "expression": "Running-time / (Running-time + Down-time) * 100",
      "variables": [
        {
          "name": "Running-time",
          "value": {
            "propertyId": "${Running-time}"
          }
        },
        {
          "name": "Down-time",
          "value": {
            "propertyId": "${Down-time}"
          }
        }
      ],
      "window": {
        "tumbling": {
          "interval": "1h"
        }
      }
    }
  },
  "unit": "Percent"
}

将此接口应用于多个资产模型时，即使基础属性名称不同（这要归功于属性映射），也会一致地计算所有资产模型的可用性指标。

有关定义指标和使用聚合函数的更多信息，请参阅聚合来自属性和其他资产（指标）的数据。

使用接口汇总指标

接口还可以定义汇总指标，用于汇总层次结构中跨资产的数据。当您在界面中定义层次结构并将其应用于资产模型时，可以创建汇总子资产数据的指标。

例如，您可以定义一个指标来计算工厂中所有 CNC 机床的平均温度：

{
  "name": "AverageTemperature",
  "dataType": "DOUBLE",
  "type": {
    "metric": {
      "expression": "avg(Temperature-in-C)",
      "variables": [
        {
          "name": "Temperature-in-C",
          "value": {
            "propertyId": "${Temperature-in-C}",
            "hierarchyId": "${CNC-machines}"
          }
        }
      ],
      "window": {
        "tumbling": {
          "interval": "1h"
        }
      }
    }
  },
  "unit": "Celsius"
}

该指标使用avg()聚合函数来计算层次结构中所有 CNC 机床的平均温度。该hierarchyId参数指定要使用哪个层次结构进行聚合。

将此接口应用于资产模型时，汇总指标会自动聚合所有与层次结构映射相匹配的子资产的数据。