注册同/环比指标¶
同/环比指标是一种特殊的虚拟指标，是通用数据服务基于指标表达式中的同/环比标识符，转换时域得到的指标。
备注
查询同/环比指标不依赖数据源提供该能力，而是由通用数据服务实现。
时域转换仅影响查询数据的范围，不影响返回结果的时戳。返回结果的时戳仍保持为查询入参的原始时戳，以便于原始指标和同/环比指标在同一次查询中同时获取并进行对标。
以下表格介绍目前支持的同/环比类型、同/环比标识符及其对应的时域转换方式。
同/环比类型 |
同/环比标识符 |
时域转换方式 |
|---|---|---|
上期（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 日。 |
上周同期（Same Period Last Week） |
SPLW |
假设查询时段为 Day(1)~Day(N)，通用数据服务会转换时段为上周的 Day(1)~Day(N)。例如查询时段为 2022 年 4 月 4 日~4 月 6 日，那么上周同期转换为 2022 年 3 月 28 日~3 月 30 日。 |
同/环比指标配置规则
注册同/环比指标是在注册业务指标时定义以下特殊配置的过程：
指标标识符 需加上同/环比标识符，例如：ActiveProductionSPLM。更多信息，参见 业务指标标识符规则。
指标名 需与原始指标加以区分，格式：
原始指标（同/环比类型）。例如：发电量指标的同/环比指标可以注册为发电量（上期）、发电量（上周同期）、发电量（上月同期）、发电量（去年同期）。是否虚拟指标 需填写
Y。指标表达式 需包含同/环比标识符，格式：
#{Metric['原始指标APIKey@@同环比标识符@@原始指标字段Key']。更多信息，参见 同/环比指标表达式案例。
同/环比指标表达式案例
下表以光伏领域的 发电量 指标（字段 Key 为 ActiveProduction，API Key 为 SolarAPI）为例，说明其对应的同/环比指标的表达式配置。
同/环比类型 |
同/环比标识符 |
指标表达式 |
|---|---|---|
上期 |
LP |
相关发电量环比指标表达式如下：
|
去年同期 |
SPLY |
相关发电量年同比指标表达式如下：
|
上月同期 |
SPLM |
相关发电量月同比指标表达式如下：
|
上周同期 |
SPLW |
相关发电量月同比指标表达式如下：
|