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