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