注册同/环比指标


同/环比指标是一种特殊的虚拟指标,是通用数据服务基于指标表达式中的同/环比标识符,转换时域得到的指标。

备注

  • 查询同/环比指标不依赖数据源提供该能力,而是由通用数据服务实现。

  • 时域转换仅影响查询数据的范围,不影响返回结果的时戳。返回结果的时戳仍保持为查询入参的原始时戳,以便于原始指标和同/环比指标在同一次查询中同时获取并进行对标。


以下表格介绍目前支持的同/环比类型、同/环比标识符及其对应的时域转换方式。


同/环比类型

同/环比标识符

时域转换方式

上期(Last Period)

LP

假设查询时段为 Day(1)~Day(N),通用数据服务会转换时段 Day(1-N)~Day(0)。例如查询时段为 4 月 1 日~4 月 5 日,那么上期转换为 3 月 27 日~3 月 31 日。

去年同期(Same Period Last Year)

SPLY

假设查询时段为 Day(1)~Day(N),通用数据服务会转换时段为去年的 Day(1)~Day(N)。例如查询时段为 2022 年 4 月 1 日~4 月 5 日,那么去年同期转换为 2021 年 4 月 1 日~4 月 5 日。

上月同期(Same Period Last Month)

SPLM

假设查询时段为 Day(1)~Day(N),通用数据服务会转换时段为上个月的 Day(1)~Day(N)。例如查询时段为 2022 年 4 月 1 日~4 月 5 日,那么上月同期转换为 2022 年 3 月 1 日~3 月 5 日。

同/环比指标配置规则


注册同/环比指标是在注册业务指标时定义以下特殊配置的过程:


  • 指标标识符 需加上同/环比标识符,例如:ActiveProductionSPLM。更多信息,参见 业务指标标识符规则

  • 指标名 需与原始指标加以区分,格式:原始指标(同/环比类型)。例如:发电量 指标的同/环比指标可以注册为 发电量(上期)发电量(上月同期)发电量(去年同期)

  • 是否虚拟指标 需填写 Y

  • 指标表达式 需包含同/环比标识符,格式:#{Metric['原始指标APIKey@@同环比标识符@@原始指标字段Key']。更多信息,参见 同/环比指标表达式案例

同/环比指标表达式案例


下表以光伏领域的 发电量 指标(字段 Key 为 ActiveProduction,API Key 为 SolarAPI)为例,说明其对应的同/环比指标的表达式配置。


同/环比类型

同/环比标识符

指标表达式

上期

LP

相关发电量环比指标表达式如下:

  • 发电量(上期)表达式:#{Metric[‘SolarAPI@@LP@@ActiveProduction’]}

  • 发电量(环比)表达式:#{Metric[‘SolarAPI@@ActiveProduction’] / Metric[‘SolarAPI@@LP@@ActiveProduction’]}

  • 发电量(环比增长)表达式:#{Metric[‘SolarAPI@@ActiveProduction’] - Metric[‘SolarAPI@@LP@@ActiveProduction’]}

  • 发电量(环比增长率)表达式:#{(Metric[‘SolarAPI@@ActiveProduction’] - Metric[‘SolarAPI@@LP@@ActiveProduction’]) / Metric[‘SolarAPI@@LP@@ActiveProduction’]}

去年同期

SPLY

相关发电量年同比指标表达式如下:

  • 发电量(去年同期)表达式:#{Metric[‘SolarAPI@@SPLY@@ActiveProduction’]}

  • 发电量(年同比)表达式:#{Metric[‘SolarAPI@@ActiveProduction’] / Metric[‘SolarAPI@@SPLY@@ActiveProduction’]}

  • 发电量(年同比增长)表达式:#{Metric[‘SolarAPI@@ActiveProduction’] - Metric[‘SolarAPI@@SPLY@@ActiveProduction’]}

  • 发电量(年同比增长率)表达式:#{(Metric[‘SolarAPI@@ActiveProduction’] - Metric[‘SolarAPI@@SPLY@@ActiveProduction’]) / Metric[‘SolarAPI@@SPLY@@ActiveProduction’]}

上月同期

SPLM

相关发电量月同比指标表达式如下:

  • 发电量(上月同期)表达式:#{Metric[‘SolarAPI@@SPLM@@ActiveProduction’]}

  • 发电量(月同比)表达式:#{Metric[‘SolarAPI@@ActiveProduction’] / Metric[‘SolarAPI@@SPLM@@ActiveProduction’]}

  • 发电量(月同比增长)表达式:#{Metric[‘SolarAPI@@ActiveProduction’] - Metric[‘SolarAPI@@SPLM@@ActiveProduction’]}

  • 发电量(月同比增长率)表达式:#{(Metric[‘SolarAPI@@ActiveProduction’] - Metric[‘SolarAPI@@SPLM@@ActiveProduction’]) / Metric[‘SolarAPI@@SPLM@@ActiveProduction’]}