新建指标

通过时间修饰词、原子词和计算逻辑等,您可配置衍生指标,然后将新建的指标应用于再次衍生、分析数据报表等业务。本文介绍新建指标的操作步骤。

前提条件

已完成导入原始定义指标和新增原子词。具体操作,请参见导入原始定义指标新增原子词

操作步骤

  1. 物联网平台控制台实例概览页面,单击目标企业版实例ID或备注名称。

  2. 在左侧导航栏,选择数据服务 > 数据指标,单击自定义指标

  3. 所有指标页签,单击新建指标

  4. 根据页面提示配置指标定义。

    1. 选择要新建的指标所属的域后,通过页面提示,选择对应的具体实体和衍生范围

      参数

      说明

      本实体

      作用到当前的实体。

      子实体

      作用到当前实体的子实体。配置衍生定义的指标时,需选择子实体。

      例如,产品的子实体为对应的设备,则该衍生定义指标是在每个设备上做衍生定义指标计算,产品不做衍生定义指标计算。 更多信息,请参见指标类型

    2. 参考如下说明,设置指标定义。

      参数

      说明

      时间修饰词

      选择时间修饰词,即新增指标统计数据的时间范围。

      原子词

      选择指标域下已添加的原子词。

      您可以单击右侧前往新建原子词添加原子词。更多信息,请参见添加原子词

      指标名称

      指标名称不可修改,默认按照时间修饰词+原子词拼接。

      例如:最近1天平均温度

      度量单位

      选择单位类型及对应的具体单位。支持的单位以页面提供的可选项为准。

      数据类型

      设置数据类型,及对应的精度、小数位数和取值范围。

      单击帮助帮助图标,可查看数据类型详细说明。

      加工方式

      基于已有指标资产衍生加工。不支持修改。

      是否可被计算

      当该指标是可以累加的数值型指标时,例如笔数、金额、次数等,可选择

      统计频率

      以日为周期计算生成数据。不支持修改。

      到期日期

      选择新增指标的到期日期。

      重要

      指标到期后,会停止调度生产数据。

      指标描述

      指标的业务描述,默认按照时间修饰词+原子词拼接。

      例如:时间修饰词:最近1天,原子词:平均温度

    3. 参考如下说明,设置计算规则。

      计算方式

      说明

      示例

      聚合计算

      下拉选择聚合函数、指标、运算符,支持最多添加10个表达式。

      选择产品域的子实体,函数COUNT(计数)和产品(od3****)的温度,表示:在产品(od3****)上,通过衍生定义指标,计算记录温度的次数。

      表达式计算

      输入框内编辑运算表达式。支持的函数请参见下文附:函数列表

      您可单击输入框上方函数,查看说明和示例。

      表达式写法:在输入框中输入聚合函数,在函数体内输入$@符号,选择指标域,输入英文句号(.),选择指标域下的实体,再输入英文句号(.),选择需要衍生计算的指标。

      其中,$@符号支持选择的指标类型不同:

      • $:原始定义和衍生定义。

      • @:原始指标和衍生指标。

      说明

      聚合函数表达式内不支持使用四则运算符。

      产品温湿度传感器下有100台设备,其中一台设备为TH_sensor,以下是基于原始指标、原始定义的温度衍生出最近一天平均温度指标表达式。

      • avg($产品.温湿度传感器.温度):在产品上通过衍生定义指标,计算所有设备的平均温度。

      • avg(@设备.TH_sensor.温度):在设备TH_sensor上,通过衍生定义指标,计算该设备的平均温度。

  5. 单击完成并上线

    您可在所有指标列表中查看到新增完成的指标。

    说明
    • 仅单击完成的指标,显示状态为未上线,暂不汇总数据。

    • 未完成配置的指标,可单击进入草稿箱,继续编辑,完成上线。

    指标
  6. (可选)在所有指标列表中,找到目标指标,单击操作栏功能按钮,可执行以下操作。

    说明

    原始定义的指标仅支持查看和删除功能。

    操作

    说明

    查看

    查看指标的基本信息、计算逻辑、数据预览等详细信息。

    编辑

    修改衍生指标配置。

    下线

    下线已上线的指标。指标下线后,相关的衍生指标和服务失败。

    上线

    上线已下线的指标。

    克隆

    可在克隆指标页面,根据页面提示,直接修改指标定义和配置,添加新指标。

    重要

    不支持保存克隆配置完全一致的指标。

    删除

    删除当前指标。

    重要

    以下场景,删除指标,会提示失败。

    • 该指标存在下游指标。

    • 该指标已在数据分析报表中使用。

后续操作

由于衍生指标是T+1日维度统计数据,新增指标后,如需立即查看到数据,需手工创建回刷任务,回刷历史数据。

具体操作,请参见指标回刷

附:函数列表

函数

说明

GREATEST

返回输入参数中最大的一个。

LEAST

返回输入参数中最小的一个。

AVG

计算平均值。

MAX

计算最大值。

MIN

计算最小值。

SUM

计算汇总值。

COUNT

计算记录数。

ABS

计算绝对值。

CEIL

计算向上取整值。

ROUND

返回四舍五入到指定小数点位置的值。

TRUNC

返回截取到指定小数点位置的值。

COALESCE

返回列表中第一个非NULL的值。