注意
时序见解服务将于 2024 年 7 月 7 日停用。 请考虑尽快将现有环境迁移到备用解决方案。 关于弃用和迁移的详细信息,请访问我们的 文档。
本文介绍指定事件公式和计算规则的时序模型变量。
每个变量可以是三种类型之一:数值、分类,以及 聚合。
- 数值 类型适用于处理连续的数值。
- 分类 类型适用于一组定义的离散值。
- 聚合 类型组合了单个类型(所有数值或所有分类)的多个变量。
下表显示了与每种变量类型相关的属性。
数值变量
| 变量属性 | 描述 | 
|---|---|
| 变量筛选器 | 筛选器是可选的条件子句,用于限制要考虑计算的行数。 | 
| 变量值 | 用于计算的遥测值来自设备或传感器,或使用时序表达式转换。 数值类型变量必须是 Double或Long才能匹配传入数据的数据类型。 | 
| 变量插值 | 插值法指定如何使用现有数据重构信号。 阶段 和 线性 插值选项可用于数值变量。 | 
| 变量聚合 | 使用支持数值变量类型的 聚合函数来执行计算。 | 
变量符合以下 JSON 示例:
"Interpolated Speed": {
  "kind": "numeric",
  "value": {
    "tsx": "$event['Speed-Sensor'].Double"
  },
  "filter": null,
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span": "P1D"
    }
  },
  "aggregation": {
    "tsx": "right($value)"
  }
}
分类变量
| 变量属性 | 描述 | 
|---|---|
| 变量筛选器 | 筛选器是可选的条件子句,用于限制要考虑计算的行数。 | 
| 变量值 | 用于计算来自设备或传感器的遥测值。 分类类型变量必须是 Long或String才能匹配传入数据的数据类型。 | 
| 变量插值 | 插值法指定如何使用现有数据重构信号。 阶跃 插值选项可用于分类变量。 | 
| 变量类别 | 类别创建从设备或传感器到标签的值之间的映射。 | 
| 变量默认类别 | 默认类别适用于未在“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 内联提供,以替代或补充存储的定义。
