注册二级指标¶
二级指标是通用数据服务基于时间维度标识符,累计特定时间段内的一级指标数值之后得到的指标。通过实时指标接口查询二级指标时,无需传入时间范围。
以下表格介绍目前支持的时间维度的类型、标识符、含义及对应的一级指标需要支持的查询间隔。
时间维度类型 |
时间维度标识符 |
描述 |
一级指标支持的查询间隔 |
---|---|---|---|
当前 |
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。一个指标最多填写一个时间维度标识符。