DB35/T 1893-2020 生态环境大数据管理平台接口规范
- 文档部分内容预览:
6.1.3查询传感器数据模型
接口名:tsTable 说明:按条件查询指定的传感器数据模型。 调用格式:GET/tsTable/(模型ID)?select=(columns) 语义: 获取满足查询条件的传感器数据模型。指定模型ID,则查询指定传感器数据模型;未指定模型 ID,则查询所有传感器数据模型。查询所有记录时,支持输入需要返回的列名,查询结果可指定每 页数量、可指定页、可排序。 调用结果: 成功状态:
DB35/T18932020
返回的HTTP状态码为201,查询结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。
电气装置标准规范范本6. 1.4 添加传感器
接口名:tsTable 说明:向指定传感器数据模型添加新的传感器相关信息。 调用格式:PUT/tsTable/addfield/(模型ID)
语义: 向指定的传感器数据模型增加传感器相关信息。附加流 指定需要添加新的传感器,支 持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为201。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。 接口名:tsTable 说明:修改指定传感器数据模型中的传感器的相关信息。 调用格式:PUT/tsTable/【模型ID)/fields/(传感器ID)
语义: 修改指定传感器数据模型中指定传感器ID的相关信息。附加流 指定需要修改的传感 器,支持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为200。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。 口名:tsTable 说明:删除指定传感器数据模型中的某个传感器的相关信息。 周用格式:DELETE/tsTable/(模型ID)/fields/【传感器ID) 语义: 当传感器数据模型中某个传感器失效或者不需要时,可以删除指定传感器的相关信息。 调用结果: 成功状态: 返回的HTTP状态码为200。 失败状态:
DB35/T 18932020
返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。
6.2传感器数据实时接入接口
6.2.1Web服务接
6.2.2消息队列服务接口
6. 2. 3Java 编程接口
6.2.3.1生成数据记录接口
接口名:GenRecord 说明:将数据转化成平台能够识别的传感器数据记录。 提供方法见表4:
DB35/T18932020
6.2.3.2SDK配置接
接口名:Config 说明:设置SDK客户端的配置参数信息。 方法:voidput(StringkeyObjectvalue) 参数如表5所示:
6.3传感器数据批量导入接口
DB35/T 18932020
DB35/T 18932020
6.3.2新建导入任务
接口名:workflows 说明:创建新导入任务。 调用格式:POST/workfloWs
语义: 新建批量导入任务。附加流 指定导入任务相关的信息,包括但不限于要导入的文件标 识等,支持JSON格式。 调用结果: 成功状态: 返回的HTTP状态码为201,生成任务ID,结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。 6.3.3上传传感器数据文件
6.3.4获取导入任务列
接口名:workflows 说明:获取正在执行的和已经执行完成的批量导入任务列表,支持分页。 息服务平台 调用格式:GET/workflows 语义: 获取正在执行的和已经执行完成的批量导入任务列表。 调用结果: 成功状态: 返回的HTTP状态码为200,查询结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。
6.3.5获取任务详情
DB35/T18932020
接口名:workflows 说明:查看批量导入任务相关的详情。 调用格式:GET/workflows/【任务ID} 语义: 根据任务ID查看导入任务的相关信息,包括任务报告。 调用结果: 成功状态: 返回HTTP状态码200,返回结果采用JSON封装,包含导入任务相关信息。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具 状态码参见5.3。
.3.6获取单个任务状态
接口名:workflows 说明:获取批量导入任务的执行状态和进度。 调用格式:GET/workflows/status/(任务ID) 语义: 根据任务ID查询某个任务状态。 调用结果: 成功状态: 返回HTTP状态码201,返回结果采用JSON封装,任务状态信息。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。
6.4传感器数据查询接口
DB35/T 18932020
DB35/T 18932020
6. 4. 2数据行查询
6.4.4数据聚合查询
DB35/T18932020
7文本/图像/视频类数据接口
7.1.1 创建对象类型
7.1.2修改对象类型
7.1.3删除对象类型
DB35/T18932020
7.1.4查询对象类型
7.2上传文本/图像/视频类数据文件
7.3.1创建对象数据
DB35/T18932020
7.3.2修改对象数据
7.3.3删除对象数据
7.3.4查询对象数据
DB35/T 18932020
DB35/T 18932020
语义: 根据指定元数据,获取满足查询条件的对象数据。查询结果可指定每页数量、可指定页、可排 序。 调用结果: 成功状态: 返回的HTTP状态码为200,查询结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体 状态码参见5.3。
7.3.5搜索对象数据
7.3.6导出对象数据
平台支持主流关系型数据库作为数据源,包括但不限于:SQLServer,MySQL和Oracle等主 数据库。 平台关系型数据接口规范按照H厂719一2014的规定。
9.1.1新建分析模型
DB35/T18932020
接口名:model 说明:创建新的分析模型。 调用格式:POST/model
语义: 创建新的分析模型,附加流 指定该分析模型使用的数据源节点、计算节点及分析流程 图等信息,支持JSON格式。数据源节点的信息包括但不限于数据源节点的唯一标识、数据源的类型、 过滤条件和获取数据的方式。计算节点的信息包括但不限于计算节点的唯一标识脚本类型、脚本参 数、脚本信息和脚本程序入口。 调用结果: 成功状态: 返回的HTTP状态码为201,生成分析模型ID,结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体状 态码参5.3。 9.1.2修改分析模型
说明:修改已存在的分析模型。 周用格式:PUT/model
语义: 修改已存在的分析模型。附加流 指定该分析模型ID、使用的数据源节点、计算节点及 分析流程图等信息,支持JSON格式。数据源节点的信息包括但不限于数据源节点的唯一标识、数据 原的类型、过滤条件和获取数据的方式。计算节点的信息包括但不限于计算节点的唯一标识脚本类 型、脚本参数、脚本信息和脚本程序入口。 调用结果: 成功状态: 返回的HTTP状态码为200,结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体状 态码参见5.3。 9.1.3查看分析模型
接口名:model 说明:查看已存在的分析模型的信息。 周用格式:GET/mode1/$(分析模型ID 语义: 查看已存在的分析模型的信息。 调用结果:
DB35/T18932020
成功状态: 返回的HTTP状态码为200。返回结果采用JSON封装,结果包含分析模型ID、使用的数据 源节点、计算节点及分析流程图等相关信息。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体状 态码参见5.3。
9.2上传分析脚本接口
9.3.1提交分析作业
接口名:jobs 说明:提交分析作业到平台。 调用格式:POST/jobs
语义: 提交运行一个分析模型实例,将分析任务提交到平台执行。附加流 指定需要运行的分 析模型信息,包括但不限于分析模型ID、分析作业名称以及其他分析需要的相关参数,支持JSON 格式。 调用结果: 成功状态: 返回的HTTP状态码为201,生成分析作业ID,结果采用JSON封装。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体状 态码参见5.3。 9.3.2查看分析作业
接口名:jobs 说明:查看分析作业。 调用格式:GET/jobs/$(分析作业ID 语义:
DB35/T18932020
查看指定的分析作业信息。 调用结果: 成功状态: 返回的HTTP状态码为200,返回结果采用JSON封装,结果包含分析作业ID、作业执行相 关信息、作业运行进度和状态等相关信息。 失败状态: 返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因,具体状 态码参见5.3。
DB35/T 18932020
附 (规范 消息队列服务接 消息队列服务接口二进制包说明见表A.1
附录A (规范性附录) 消息队列服务接口二进制包说明
B.1适用于历史数据统计型分析查询
DB35/T18932020
家具标准附录B (规范性附录) 聚合类型与数据类型的适用关系表
DR35/T 18932020
DR35/T18932020
B.2适用于历史数据探索素型分析查询
适用历史数据探索型分析查询的传感器数据类型见表B.2
适用历史数据探索型分析查询的传感器数据类型见表B.2
给排水工艺、技术[1]GB/T35295—2017信息技术大数据术语 2] GB/T35589—2017信息技术大数据技术参考模型 HJ418一2007环境信息系统集成技术规范 4 HJ/T419一2007环境数据库设计与运行管理规范 51 HJ718一2014环境信息共享互联互通平台总体框架技术规范 [6]HI966—2018生态环境信息基本数据集编制规范
DB35/T18932020
建省地方标准 生态环境大数据管理平台接口规范 DB35/T1893—2020
....- 数据标准 环境标准
- 相关专题: