注册同/环比指标¶
同/环比指标是一种特殊的虚拟指标,是通用数据服务基于指标表达式中的同/环比标识符,转换时域得到的指标。
备注
查询同/环比指标不依赖数据源提供该能力,而是由通用数据服务实现。
时域转换仅影响查询数据的范围,不影响返回结果的时戳。返回结果的时戳仍保持为查询入参的原始时戳,以便于原始指标和同/环比指标在同一次查询中同时获取并进行对标。
以下表格介绍目前支持的同/环比类型、同/环比标识符及其对应的时域转换方式。
同/环比类型 |
同/环比标识符 |
时域转换方式 |
---|---|---|
上期(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 |
相关发电量环比指标表达式如下:
|
去年同期 |
SPLY |
相关发电量年同比指标表达式如下:
|
上月同期 |
SPLM |
相关发电量月同比指标表达式如下:
|