介绍数据聚合查询服务的API接口。

查询数据

定义描述

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 分页大小

查询对象表达式对象

参数名 参数类型 详细描述
op String and/or
filters List 多个过滤对象
exprs List 多个查询表达式对象

过滤对象对象

参数名 参数类型 详细描述
col String 匹配字段
comp String 比较操作符 = != > < >= <= in not-in like not-like
val Object 比较值

返回参数

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

示例

  • 请求示例
    {
        "iotId": "DTfdxTcIXpDfesrpo7Ur001055ed00",
        "cols": [
            "iot_id",
            "attribute",
            "count_Num",
            "date_time"
        ],
        "expr": {
            "filters": [
                {
                    "col": "date_time",
                    "comp": ">=",
                    "val": "2018-09-09 00:00:01",
                    "valueType": "int"
                },
                {
                    "col": "date_time",
                    "comp": "<",
                    "val": "2018-09-16 00:00:01",
                    "valueType": "int"
                }
            ],
            "op": "and"
        },
        "pageNo": 1,
        "pageSize": 10,
        "tableName": "ads_ilop_kv_count_di"
    }
    					
  • 正常返回示例
    {
        "code": 200,
        "data": [{
                "count_Num": 7,
                "iot_id": "BPLjau0xw3CyuRKcOtUj0010348a00",
                "date_time": "2018-04-19 00:00:00",
                "attribute": "_sys_device_pid"
            }]
    }
    					

接口支持的表以及列信息

表 1. 属性统计小时(ads_ilop_kv_state_hourly)
存储列名称 存储列数据类型 存储列数据描述
iot_id String 设备唯一身份标示
attribute String 产品功能定义Identifier
sum_num Int 属性上报数据按小时求和
avg_num Int 属性上报数据按小时求平均
date_time TimeStamp 统计日期,格式为yyyy-mm-dd hh:MM:ss
表 2. 属性统计天(ads_ilop_kv_state_daily)
存储列名称 存储列数据类型 存储列数据描述
iot_id String 设备唯一身份标示
attribute String 产品功能定义Identifier
sum_num Int 属性上报数据按天求和
avg_num Int 属性上报数据按天求平均
date_time TimeStamp 统计日期,格式为yyyy-mm-dd hh:MM:ss
表 3. 属性统计月(ads_ilop_kv_state_monthly)
存储列名称 存储列数据类型 存储列数据描述
iot_id String 设备唯一身份标示
attribute String 产品功能定义Identifier
sum_num Int 属性上报数据月度求和
avg_num Int 属性上报数据月度求平均
date_time TimeStamp 统计日期,格式为yyyy-mm-dd hh:MM:ss
表 4. 设备事件历史记录聚合(r_ilop_event_aggre_di)
存储列名称 存储列数据类型 存储列数据描述
batch_id String 事件上报request_id
iot_id String 设备唯一身份标示
event_code String 事件Identifier
data_value String 设备上报事件原始内容
client_date TimeStamp 设备端发送时间
service_date TimeStamp 服务端处理事件