提供设备级别常见的上报数据记录(分属性、服务、事件)和聚合查询的接口 ,以及支持的上报记录和聚合数据种类。

查询数据

定义描述

path 版本 描述 是否需要用户身份的鉴权
/datacenter/data/aggregate/query 1.0.0 查询设备纬度的的记录/统计聚合数据 是,客户端SDK需启用身份的鉴权,进行身份认证

请求参数

参数名 参数类型 详细描述
iotId String 设备ID
cols List 需要查询的列
tableName String 表名称
expr 查询对象表达式对象
orderBy 排序设置
  • col:列名
  • type:
    • asc:升序
    • desc:降序

示例:[{“col”:“id”,“type”:“asc”}]

pageNo Integer 分页位置,最小1
pageSize Integer 分页大小
表 1. 请求参数中expr字段描述
参数名 参数类型 详细描述
op String and/or
filters List 多个过滤对象
exprs List 多个查询表达式对象数组,exprs表示一个或多个expr(expr中可以嵌套expr,嵌套的expr个数不限)
表 2. exprfilters字段描述
参数名 参数类型 详细描述
col String 匹配字段
comp String 比较操作符 = != > < >= <= in not-in like not-like
val Object 比较值

返回参数

参数名 参数类型 详细描述
code INT
data JSONObject 自建表查询结果
message String 错误信息提示,不通错误提示不同

示例

  • 请求示例
    {
        "iotId":"example_iot_id",
        "pageNo":1,
        "pageSize":24,
        "expr":{
            "op":"and",
            "filters":[
                {
                    "val":"TargetHumidity",
                    "comp":"=",
                    "col":"attribute"
                },
                {
                    "val":"2019-10-12 00:00:00",
                    "comp":">=",
                    "col":"date_time"
                },
                {
                    "val":"2019-10-13 00:00:00",
                    "comp":"<",
                    "col":"date_time"
                }
            ]
        },
        "cols":[
            "sum_num",
            "avg_num",
            "date_time"
        ],
        "tableName":"ads_ilop_kv_state_hourly"
    }           
  • 正常返回示例
    {
        "code":200,
        "data":[
            {
                "sum_num":40,
                "date_time":"2019-10-12 00:00:00",
                "avg_num":20
            },
            {
                "sum_num":2260,
                "date_time":"2019-10-12 08:00:00",
                "avg_num":20
            },
            {
                "sum_num":80,
                "date_time":"2019-10-12 09:00:00",
                "avg_num":20
            }
        ],
        "localizedMsg":"",
        "message":""
    }      

接口支持的表和列信息

表 3. 按小时聚合统计属性/服务的数据(ads_ilop_kv_state_hourly)

小时聚合数据保存时间为7天

存储列名称 存储列数据类型 存储列数据描述
iot_id String 设备唯一身份标识
attribute String 产品功能定义Identifier
sum_num Int 设备上报的属性/服务数据,按小时求和
avg_num Int 设备上报的属性/服务数据,按小时求平均
date_time TimeStamp 统计日期,格式为yyyy-mm-dd hh:MM:ss
表 4. 按天聚合统计属性/服务的数据(ads_ilop_kv_state_daily)

天聚合数据保存时间为30天

存储列名称 存储列数据类型 存储列数据描述
iot_id String 设备唯一身份标识
attribute String 产品功能定义Identifier
sum_num Int 设备上报的属性/服务数据,按天求和
avg_num Int 设备上报的属性/服务数据,按天求平均
date_time TimeStamp 统计日期,格式为yyyy-mm-dd hh:MM:ss
表 5. 按月(自然月)聚合统计属性/服务的数据(ads_ilop_kv_state_monthly)

月聚合数据保存时间为365天

存储列名称 存储列数据类型 存储列数据描述
iot_id String 设备唯一身份标识
attribute String 产品功能定义Identifier
sum_num Int 设备上报的属性/服务数据,按自然月求和
avg_num Int 设备上报的属性/服务数据,按自然月求平均
date_time TimeStamp 统计日期,格式为yyyy-mm-dd hh:MM:ss
表 6. 历史事件数据的记录(r_ilop_event_aggre_di)

设备所有上报的历史事件数据的记录集合,事件聚合数据保存时间为 30天

存储列名称 存储列数据类型 存储列数据描述
batch_id String 事件上报request_id
iot_id String 设备唯一身份标识
event_code String 事件Identifier
data_value String 设备上报事件原始内容
client_date TimeStamp 设备端发送时间
service_date TimeStamp 服务端处理时间