DB34T4856-2024水库水闸实时工情信息共享技术规范

ICS35.020CCSICS35.020CCSL70安 徽 省 地 方 标 准DB34/T4856—2024水库水闸实时工情信息共享技术规范Technicalspecificationforreal-timeengineeringinformationsharingofreservoirsandwatergates20242024073020240830安徽省市场监督管理局发布..前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省水利厅提出并归口。（水利部淮河水利委员会（心站）、安徽省大禹水利工程科技有限公司。本文件起草人：方应东、刘超、贾飞、刘怀利、郑开发、马浩、杨玉喜、刘春、王朝辉、杨继伟、沈超、马顺、赵辉、王铭铭、方婧、卓超、谢力、何志祥、杨剑。水库水闸实时工情信息共享技术规范范围本文件规定了水库水闸实时工情信息共享的基本要求、共享流程和共享接口。本文件适用于水库水闸实时工情信息的共享。规范性引用文件（包括所有的修改单适用于本文件。SL725水利水电工程安全监测设计规范SL768水闸安全监测技术规范术语和定义3.1实时工情信息 realtimeengineering3.1实时工情信息 realtimeengineeringinformation水利工程运行状况类的即时信息。3.2定向移动无线通信网络 directionalmobilewirelesscommunicationnetwork固定接收地址的无线传输移动通信网络。4基本要求共享原则一致性：应保证共享的数据总量、数据指标项、数据属性前后端一致。完整性：应保证共享信息内容完整。及时性：应保证信息传输过程及时可靠。共享效率共享信息单次交换过程应不高于1s。传输要求传输网络应采用水利专网或定向移动无线通信网络，带宽应不低于2MB。敏感数据应采用加密方式传输。网络安全防护设备。共享内容与方式共享要素参照SL725SL768A。共享应采用标准化接口服务方式进行。数据存储应做好数据权限控制。应保证数据存储介质的安全性。应定期完成数据库备份，全量备份每周至少一次，增量备份每日至少一次。异常处理应支持缺漏数据的补充提交。应支持突变数据的自动筛选。应支持重复数据的自动过滤。应具备其他异常数据处理机制。共享流程共享输出方中间数据库接口1。共享输出方中间数据库接口推送推送推送推送图1信息共享流程图5.2中间数据库应采用标准化数据库表结构，见附录B。6共享接口接口类型应采用基于HTTP协议的Restful接口。接口格式应采用JSON数据格式。接口设计接口设计见附录C。共享接收方接口附录A（资料性）水库水闸实时工情信息主要共享内容水库水闸实时工情信息主要共享内容见表A.1。表A.1水库水闸实时工情信息主要共享内容表序号共享内容单位标识符引导符1观测时间引导符F0F0H2测站编码引导符F1F1H3人工置数F2F2H4库（闸、站）下水位m3AYYH5库（闸、站）上水位m3BYYH6取（排）水口水位m3CYYH7雨量mm25YYH8总出库流量、过闸总流量m3/s30YYH9取（排）水口流量m3/s28YYH10电池电压V38YYH11闸坝、水库闸门开启高度m09YYH12坝体水平位移（径向）mmFF01YYH13坝体水平位移（切向）mmFF02YYH14坝体垂直位移mmFF03YYH15坝体斜度°FF04YYH16坝体接缝、裂缝开合度°FF05YYH17近坝岸坡水平位移（径向）mmFF06YYH18近坝岸坡水平位移（切向）mmFF07YYH19近坝岸坡垂直位移mmFF08YYH20近坝岸坡斜度°FF09YYH21地下洞室围岩水平位移（径向）mmFF10YYH22地下洞室围岩水平位移（切向）mmFF11YYH23地下洞室围岩垂直位移°FF12YYH24地下洞室围岩斜度°FF13YYH25坝体渗流压力KpaFF14YYH26坝体渗流量m3/sFF15YYH27坝基渗流压力KpaFF16YYH28坝基渗流量m3/sFF17YYH29绕坝渗流压力KpaFF18YYH30绕坝渗流量m3/sFF19YYH31近坝岸坡渗流压力KpaFF20YYH32近坝岸坡渗流量m3/sFF21YYH33地下洞室渗流压力KpaFF22YYH34地下洞室渗流量m3/sFF23YYH35坝体应力KpaFF24YYH36坝基应力KpaFF25YYH37土压力KpaFF26YYH38孔隙水压力KpaFF27YYH39气温℃FF28YYH40库水温℃FF29YYH41坝体温度℃FF30YYH42坝基温度℃FF31YYH43近坝岸坡温度℃FF32YYH44地下洞室温度℃FF33YYH序号共享内容单位标识符引导符45剩余电量VFF34YYH46太阳能板状态FF35YYH47渗压仪表状态FF36YYH48渗流仪表状态FF37YYH49变形仪表状态FF38YYH50视频/图像URLFF39YYH附录B（资料性）水库水闸实时工情信息共享中间数据库表结构B.1。表B.1工情信息共享变量表编号名称数据类型长度小数位允许空值主键默认值说明1VAR_IDvarchar240NY采集量标识符1字节2CATEGORY_NAMEvarchar2320YN分类名称3VAR_NAMEvarchar2300NN变量名称4VAR_UNITvarchar2320YN变量单位5VAR_LENnvarchar220YN第一位为变量整数位占用的字节数，第二位为变量的小数位数6VAR_TYPEnumber380YN11数字2字符串B.2。表B.2工情信息历史数据表编号名称数据类型长度小数位允许空值主键默认值说明1ennmcdvarchar2100NN监测设备编号（sim卡后10位，5字节）2channelNumbervarchar220NN监测点通道号3varIddate70YN采集变量4varValuedate70NN采集值5collectTimevarchar2640NY采集时间6tssysdate入库时间附录C（资料性）水库水闸实时工情信息共享接口实时工情信息查询接口获取工情实时数据接口接口描述：获取工情实时数据接口。接口地址：/getEngineeringRealTime。接口协议：http/get。C.1。表C.1接口输入参数表输入/输出参数参数类型说明及书写规范输入EnnmcdString工程编码，水库\水闸编码C.2。获取工情历史数据接口接口描述：获取工情历史数据接口。接口地址：/getEngineeringHistory。获取工情历史数据接口接口描述：获取工情历史数据接口。接口地址：/getEngineeringHistory。接口协议：http/get。C.3。输入/输出参数参数类型说明及书写规范输出codeint接口返回代码0是成功，1是失败输出msgString如果失败返回异常信息输出dataArray[{"ennmcd":"340123023000025",//工程编码"ennm":"",//工程名称"channelNumber":"1",//工情监测点通道号，例如1#闸口"varId":"89"，//工情采集变量类型，例如开度变量"varValue":"27.93"，//工情采集变量值"varName":"闸门开启高度"，//工情采集变量类型名称"varUnit":"m", //工情采集变量单"collectTime":"2024-03-1814:10:00",//工情数据采集时间"ts":"2024-03-1814:15:00"，//工情数据入库时间}]表C.3接口输入参数表输入/输出参数参数类型说明及书写规范输入ennmcdString工程编码，水库\水闸编码输入startTimedate开始时间输入endTimedate结束时间C.1.2.5接口输出参数见表C.4。表C.4接口输出参数表输入/输出参数参数类型说明及书写规范输出codeInt接口返回代码0是成功，1是失败输出msgString如果失败返回异常信息输出dataObject结果集输出totalint记录总数输出rowsArray{"total":1,"rows":[{"ennmcd":"340123023000025",//工程编码"ennm":"”,//工程名称'"collectTime":"2024-03-1814:10:00",//工情数据采集时间"ts":"2024-03-1814:15:00"，//工情数据入库时间"pointList":[{"channelNumber":"1",//工情监测点通道号"varId":"69"//工情采集变量类型，例如开度变量"varValue":"27.93"，//工情采集变量值"varName":"闸门开启高度"，"varUnit":"m",//工情采集变量单位}]}]}实时工情信息推送接口实时工情信息推送接口接口描述：推送工情实时数据接口。接口地址：/putEngineeringRealData。接口协议：http/POST。C.5。表C.5接口输入参数表输入/输出参数参数类型说明及书写规范输入ennmcdString工程编码，水库\水闸编码输入co