关键概念¶
通用数据服务的用户和权限系统继承了 EnOS 应用门户。开始之前，需了解应用门户的 相关概念。
以下为通用数据服务的相关概念。
数据源¶
数据源是使用通用数据服务查询数据的基础，数据提供方必须先将数据源 API 按照通用数据服务规范进行标准化并注册到通用数据服务，数据消费者才可以在通用数据服务中查询到相关数据。
根据生效范围的不同，数据源分为两种：
- 公有数据源跨 OU 全局生效。
- 私有数据源只对当前 OU 生效。
更多信息，参见 注册数据源。
（虚拟）属性¶
属性是在 EnOS 模型上定义的资产的静态描述信息。例如：逆变器的名称、型号，光伏场站的经纬度等。更多信息，参见 模型定义。
虚拟属性并非定义在 EnOS 模型上的常规属性，而是在通用数据服务中基于一个或多个参数配置表达式定义的非模型属性。其中，参数可以是来自 EnOS 模型的属性、注册到通用数据服务的数据源接口提供的属性、常数等。例如：通用数据服务可以定义光伏场站的虚拟属性 运行逆变器数量，其计算方式为 正常运行逆变器数量+低性能运行逆变器数量+限功率运行逆变器数量。更多信息，参见 注册虚拟属性。
根据数据生效范围的不同，虚拟属性分为两种：
- 公有属性对当前环境里的全部 OU 生效。
- 私有属性只对当前 OU 生效。
使用通用数据服务既可以查询 EnOS 模型属性，也可以查询自定义的虚拟属性。
（虚拟）测点¶
测点是在 EnOS 模型上定义的资产运行状态的描述信息。例如：温度、压力、电流、电压等。更多信息，参见 模型定义。
虚拟测点并非定义在 EnOS 模型上的常规测点，而是在通用数据服务中基于一个或多个参数配置表达式定义的非模型测点。其中，参数可以是模型测点、常数、属性等。例如：通用数据服务可以定义虚拟测点 出力比，其配置公式为 有功功率/装机容量。更多信息，参见 注册虚拟测点。
根据数据生效范围的不同，虚拟测点分为两种：
- 公有测点对当前环境里的全部 OU 生效。
- 私有测点只对当前 OU 生效。
使用通用数据服务既可以查询 EnOS 模型测点，也可以查询自定义的虚拟测点。
指标¶
指标是衡量目标总体特征的统计数值，是能体现某一业务活动中业务状况的数值指示器。例如：发电量、损失电量、故障率等。
从生效范围看，通用数据服务的指标分为公有指标和私有指标；从数据用途看，分为原始指标和标准指标。
公有/私有指标¶
根据数据生效范围的不同，指标分为两种：
- 公有指标对当前环境里的全部 OU 生效。
- 私有指标只对当前 OU 生效。
如果私有指标和公有指标的指标标识符相同，在查询时通用数据服务优先返回私有指标，便于基于实际需求定制指标。
标准/原始指标¶
根据数据用途的不同，指标分为两种：
- 原始指标：数据源 API 中的提供的原始指标内容。原始指标只能作为定义标准指标的素材，无法通过通用数据服务 API 被查询和使用。更多信息，参见 注册原始指标。
- 标准指标：通用数据服务 API 对外暴露的指标。标准指标是直接面向数据消费者的通用数据服务 API 的指标查询对象。更多信息，参见 注册标准指标。
一级/二级指标¶
通用数据服务可以对部分指标进行固定时段的快速查询，固定时段包括当日、当月、当年等。例如：对于 发电小时数（Yield） 指标，通用数据服务可以通过注册 当日发电小时数（Yield:TD） 返回当天 0 点到当前时间点之间的发电小时数。
根据是否支持固定查询时段，标准指标分为：
- 一级指标：通用指标，查询时需要指定时间范围。
- 二级指标：通用指标的子指标，指标标识符包含 TD（当日）、MTD（当月）、YTD（当年）等时间维度标识符，查询时不需要指定时间范围。更多信息，参见 注册二级指标。
在 标准指标 菜单内，所有二级指标都自动挂载在关联的一级指标下。点开指标前方的加号图标 
可查看所有与之关联的二级指标。
透传/虚拟指标¶
简单场景下原始指标和标准指标一一对应；但在复杂场景里，标准指标是对原始指标的扩展。
根据与原始指标的对应关系，标准指标分为：
- 透传指标：与原始指标一一对应的标准指标。
- 虚拟指标：也叫计算指标，是基于原始指标和表达式计算得到的标准指标。虚拟指标与原始指标并不是一一对应关系。虚拟指标的表达式可包含四则运算、数值判断等逻辑，其结果不是由数据源直接提供，而是在每次查询时由通用数据服务基于表达式进行实时计算后返回。这类指标并不会在通用数据服务中进行存储，因此被称为“虚拟指标”。更多信息，参见 注册虚拟指标。
同/环比指标¶
作为一种特殊的虚拟指标，同/环比指标是通用数据服务基于指标表达式中的同/环比标识符，转换时域得到的新指标。
- 环比指标是与原始指标统计段相连的上次统计段之间的指标。
例如：对于
发电量（上期）指标，如果查询时段为 4 月 1 日~4 月 5 日，那么通用数据服务返回 3 月 27 日~3 月 31 日的发电量。 - 同比指标有两种，年同比表示去年同时段的指标，月同比是上个月同时段的指标。
例如：对于
发电量（去年同期）和发电量（上月同期）指标，如果查询时段为 2022 年 4 月 1 日~4 月 5 日，那么通用数据服务分别返回 2021 年 4 月 1 日~4 月 5 日和 2022 年 3 月 1 日~3 月 5 日的发电量。
更多信息，参见 注册同/环比指标。
记录类型¶
记录类型是非时序的事实数据的类型。例如：告警、预警、服务申请、工单等。区别于指标、测点等时序数据，记录类型没有查询间隔，也不支持聚合计算和配置虚拟数据等能力。
根据数据生效范围的不同，记录类型分为两种：
- 公有记录类型对当前环境里的全部 OU 生效。
- 私有记录类型只对当前 OU 生效。
更多信息，参见 注册记录类型。