注册二级指标


二级指标是通用数据服务基于时间维度标识符,累计特定时间段内的一级指标数值之后得到的指标。通过实时指标接口查询二级指标时,无需传入时间范围。


以下表格介绍目前支持的时间维度的类型、标识符、含义及对应的一级指标需要支持的查询间隔。


时间维度类型

时间维度标识符

描述

一级指标支持的查询间隔

当前

L

当前时间点

L

当日

TD

当天 0 点~当前时间点

D

当月

MTD

当月 1 日 0 点~当前时间点

M

当年

YTD

当年 1 月 1 日 0 点~当前时间点

Y

当月期末

TM

当月 1 日 0 点~次月 1 日 0 点

M

当年期末

TY

当年 1 月 1 日 0 点~次年 1 月 1 日 0 点

Y

总累计

BOL

全生命周期

T


备注

  • TM/TY 与 MTD/YTD 的差别在于:TM/TY 指完整的当月/当年;而 MTD/YTD 指截止到当日的当月/当年。

  • 时间维度仅决定通用数据服务取数据的时间范围,不代表数据源实际更新数据的时间。例如:如果数据源最近一次更新数据是在 5 时整,那么在 5 时 04 分查询当日数据时,实际查询到的数据是到 5 时整的数据。

二级指标配置规则


注册二级指标是在注册标准指标时定义以下特殊配置的过程:


  • 指标标识符 需加上时间维度标识符作为后缀,例如:PlannedYield:MTD。更多信息,参见 标准指标标识符规则

  • 指标名 需与一级指标加以区分,格式为:一级指标(时间维度类型)。例如:计划等效利用小时数 指标的二级指标可以注册为 计划等效利用小时数(当日)计划等效利用小时数(当月期末)计划等效利用小时数(总累计)

  • 是否虚拟指标 需与对应的一级指标保持一致。

  • 关联的一级指标 需填写对应的一级指标的标识符,例如:PlannedYield。

  • 二级指标维度 需填写所需的时间维度标识符,例如:MTD。一个指标最多填写一个时间维度标识符。