关键概念¶
通用数据服务的用户和权限系统继承了 EnOS 应用门户。开始之前,需了解应用门户的 相关概念。
以下为通用数据服务的相关概念。
业务对象类型 ¶
业务对象类型(mdm type)简称对象类型,可被指标/测点/属性引用,用于定义数据所属的资产类型。对象类型包含场站类型(如风场、楼宇等)、设备类型(如电量表、储能系统等)、部件类型(如电池组、电池簇等)等多种层级。
根据数据生效范围的不同,对象类型分为两种:
公有对象类型对当前环境里的全部 OU 生效。
私有对象类型只对当前 OU 生效。
业务对象类型关联 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 生效。
更多信息,参见 注册记录类型。
维度类型 ¶
维度类型可被业务指标引用,用于定义该业务指标支持的聚合查询维度。例如:资产类型、省份、厂家等。
根据数据生效范围的不同,维度类型分为两种:
公有维度类型对当前环境里的全部 OU 生效。
私有维度类型只对当前 OU 生效。
更多信息,参见 注册维度类型。
基础信息 ¶
基础信息是与业务实体相关的具有共享性的数据。通用数据服务中的基础信息主要用于预定义在指标模板中使用的标准业务信息,例如:指标类型、主题域等。
根据数据生效范围的不同,基础信息分为两种:
公有基础信息对当前环境里的全部 OU 生效。
私有基础信息只对当前 OU 生效。
更多信息,参见 管理基础信息。
指标模板 ¶
指标模板汇总了与特定对象类型关联的指标的基础信息和扩展信息(如指标的标识符、名称、查询间隔、聚合方式、单位等)。指标模板适用于指标数据的打通和共享等典型场景,例如:使用数据模板将通用数据服务的指标周期性同步到其他数据管理服务中,保证数据的标准化和一致性。
根据数据生效范围的不同,指标模板分为两种:
公有指标模板对当前环境里的全部 OU 生效。
私有指标模板只对当前 OU 生效。
更多信息,参见 管理指标模板。