TSDB数据服务概述¶
基于TSDB的资产数据服务。EnOS时序数据库(TSDB)为设备上传的实时数据和经流数据处理的数据、以及通过离线通道整合的时序数据提供高效和稳定的存储和管理。目前EnOS的TSDB数据库支持存储资产的:
AI测点原始数据
AI测点分钟级归一化数据
设备状态(DI)数据
通用类型数据
电量数据
有关TSDB存储的详细信息,参见 时序数据管理。
针对以上数据类型,TSDB服务提供以下配套的接口供开发者调用获取数据并进行应用开发。
API列表¶
API名称 |
描述 |
---|---|
过滤查询多个设备单个测点的最新数据。支持查询的数据类型为Numeric和String |
|
获取指定设备的指定测点在某段时间内的AI原始数据 |
|
获取指定设备的指定测点在某段时间内的AI原始数据 |
|
获取指定设备从本地时间0点开始到当前时间已累计的电量数据 |
|
获取指定设备在某段时间内的状态(DI)数据 |
|
获取指定设备在一段时间内不同状态(DI)的时长 |
|
获取指定设备在某段时间内的电量数据 |
|
获取指定设备的指定测点在某段时间内通用类型的数据 |
|
获取指定设备所有测点的最新数据 |
|
获取指定设备的指定测点在某段时间内原始数据的值(包括AI、DI、和通用数据类型) |
API请求方法¶
TSDB数据服务API V2.0 支持GET和POST两种请求方法:
GET方法:请求参数包含在请求URL中,适用于请求参数较少的情况
POST方法:请求参数以表单的形式包含在请求体中,适用于请求参数较长的情况
API参考文档包含了对两种请求方法的详细说明。
通用错误码 ¶
代码 |
错误信息 |
描述 |
---|---|---|
0 |
Success |
API调用成功。 |
400 |
Invalid param error |
存在不合法的请求参数,具体信息请查看error message。 |
701 |
Data service ERROR |
服务出错。 |
702 |
An error occurred when execute query in data service |
查询数据服务异常。 |