时序模型变量

注意

时序见解服务将于 2024 年 7 月 7 日停用。 请考虑尽快将现有环境迁移到备用解决方案。 有关弃用和迁移的详细信息,请访问我们的 文档

本文介绍指定事件公式和计算规则的时序模型变量。

每个变量可以是三种类型之一:数值分类,以及 聚合

  • 数值 类型适用于连续数值。
  • 分类 类型适用于一组定义的离散值。
  • 聚合 类型组合了单个类型(所有数值或所有分类)的多个变量。

下表显示了与每种变量类型相关的属性。

时序模型变量表

数值变量

变量属性 描述
变量筛选器 筛选器是可选的条件子句,用于限制要考虑计算的行数。
变量值 用于计算的遥测值来自设备或传感器,或使用时序表达式转换。 数值类型变量必须是 DoubleLong 才能匹配传入数据的数据类型。
变量插值 插值法指定如何使用现有数据重构信号。 阶段线性 插值选项可用于数值变量。
变量聚合 使用支持数值变量类型的 聚合函数来执行计算。

变量符合以下 JSON 示例:

"Interpolated Speed": {
  "kind": "numeric",
  "value": {
    "tsx": "$event['Speed-Sensor'].Double"
  },
  "filter": null,
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span": "P1D"
    }
  },
  "aggregation": {
    "tsx": "right($value)"
  }
}

分类变量

变量属性 描述
变量筛选器 筛选器是可选的条件子句,用于限制要考虑计算的行数。
变量值 用于计算来自设备或传感器的遥测值。 分类类型变量必须是 LongString 才能匹配传入数据的数据类型。
变量插值 内插指定如何使用现有数据重新构造信号。 步骤 内插选项可用于分类变量。
变量类别 类别创建从设备或传感器到标签的值之间的映射。
变量默认类别 默认类别适用于未在“categories”属性中映射的所有值。

变量符合以下 JSON 示例:

"Status": {
  "kind": "categorical",
  "value": {
     "tsx": "$event.Status.Long"
},
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span" : "PT1M"
    }
  },
  "categories": [
    {
      "values": [0, 1, 2, 3],
      "label": "Good"
    },
    {
      "values": [4],
      "label": "Bad"
    }
  ],
  "defaultCategory": {
    "label": "Not Applicable"
  }
}

聚合变量

变量属性 描述
变量筛选器 筛选器是可选的条件子句,用于限制要考虑计算的行数。
变量聚合 通过聚合变量类型支持的 聚合函数执行计算。

变量符合以下 JSON 示例:

"Speed Range": {
  "kind": "aggregate",
  "filter": null,
  "aggregation": {
    "tsx": "max($event.Speed.Double) - min($event.Speed.Double)"
  }
}

变量存储在时序模型的类型定义中,可以通过 API 内联提供,以替代或补充存储的定义。

后续步骤