DL/T 1456-2015
基本信息
标准号： DL/T 1456-2015
中文名称：电力系统数据库通用访问接口规范
标准类别：电力行业标准(DL)
标准状态：现行
出版语种：简体中文
下载格式：.zip .pdf
下载大小：2615932
标准分类号
关联标准
出版信息
相关单位信息
标准简介
DL/T 1456-2015.General call interface specification of database for electrie power system.
1范围
DL/T 1456规定了电力系统实时数据库、时间序列实时数据库、时间序列历史数据库和关系数据库的通用访问接口，明确了接口功能和参数定义等技术要求。
DL/T 1456适用于电网调度控制系统、配电自动化系统及其他与电力生产运行相关的应用软件的设计开发、测试验证、升级改造等工作，厂站监控系统可参照执行。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
GB/T 12991.1信息技术 数据库语言 SQL第1部分:框架(ISO/IEC 9075-1，IDT)
GB/T 30149电网通 用模型描述规范
ISO/IEC 9075-2 Information technology-Database languages- SQL- -Part 2: Foundation
ISO/IEC 9075-3 Information technology-Database languages- SQL- -Part 3: CallLevel Iterface
3术语和定义
下列术语和定义适用于本标准。
3.1应用application
在电力系统应用软件中，用于完成特定任务、互相紧密关联的一组功能集合，包括稳态监控应用、网络分析应用、自动发电控制应用等。
3.2态context
在电力系统应用软件中，用于描述应用的运行环境，通常与时间相关，包括实时态、研究态、规划态、测试态、反演态、培训态等。每个态中包含一组应用集合，如实时态中可包含稳态监控应用和网络
分析应用等。
1范围
DL/T 1456规定了电力系统实时数据库、时间序列实时数据库、时间序列历史数据库和关系数据库的通用访问接口，明确了接口功能和参数定义等技术要求。
DL/T 1456适用于电网调度控制系统、配电自动化系统及其他与电力生产运行相关的应用软件的设计开发、测试验证、升级改造等工作，厂站监控系统可参照执行。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
GB/T 12991.1信息技术 数据库语言 SQL第1部分:框架(ISO/IEC 9075-1，IDT)
GB/T 30149电网通 用模型描述规范
ISO/IEC 9075-2 Information technology-Database languages- SQL- -Part 2: Foundation
ISO/IEC 9075-3 Information technology-Database languages- SQL- -Part 3: CallLevel Iterface
3术语和定义
下列术语和定义适用于本标准。
3.1应用application
在电力系统应用软件中，用于完成特定任务、互相紧密关联的一组功能集合，包括稳态监控应用、网络分析应用、自动发电控制应用等。
3.2态context
在电力系统应用软件中，用于描述应用的运行环境，通常与时间相关，包括实时态、研究态、规划态、测试态、反演态、培训态等。每个态中包含一组应用集合，如实时态中可包含稳态监控应用和网络
分析应用等。
标准图片预览
标准内容
ICS 29.240.30
备案号：50776-2015
中华人民共和国电力行业标准
DL/T1456—2015
电力系统数据库通用访问接口规范General call interface specification of database for electric power system2015-07-01发布
国家能源局
2015-12-01实施
规范性引用文件
术语和定义…
缩略语
5数据库功能和炎型
6实时数据库访问接口
7时间序列实时数据库访问接口
8时间序列历史数据库访问接口
9关系数据库访问接「」（DCI）目bzxZ.net
附录A（规范性附录）室
实时数据库访问接口数据结构
附录B（规范性附录）【
时闻序列实时数据访问接数粘结构附录C（规范性附录）时问序列历史数据库访问接口数据结构附录D（规范性附录）关系数据库访问接口（DCI）山使用的句柄及描述符DL/T1456
DL/T1456—2015
为规范电网调度控制系统、配电动化系统等应用软件对各类数据库的访问接口，指导相关系统及其应用功能的设计开发、测试验证利升级改造，制定本标准。本标准按照GB/1'1.1-2009《标准化工作则第1部分：标准的结构和编写》给出的规则起草：本标准由中国电力企业联介会提山：本标准由全国中网运行与控制标准化技术委员会（SAC/IC446）归口。本标准起节单位：南京南瑞集闭公司、国家电网公司国家电力调度控制中心、南方中网有限责任公司电力调度控制中心、中国中力科学研究院、北京四方继保自动化股份有限公司、武汉达梦数据库有限公司、北京人大金仓信息技术股份有限公司、家电网公削华中分部、网江苏省电力公司、国网江匹省电力公司、国网浙江省电力公司。本标准主要起草人：严亚勤、梁寿总、翼明下、瀚洪倚、彭晖、陈鹏、张伟、葛云鹏、1瑾、吴庆曦谢晓冬、张杰、李海华、马志斌、厉鹏、花静、李宇仕、闺湖、詹庆才、刘涛、金学成、徐存需、古震滨、于宏文。
本标准在执行过程的意见或建议请反馈至国电力企业联合会标准化管理心（北京市自）路一条—号，100761)。
1范围
电力系统数据库通用访问接口规范DL/T1456
本标准规定了电力系统实时数据库、时间序列实时数据库、时问序列历史数据库利关系数据库的通川访问接1「，明确了接口功能和参数定义等技术要求。本标准适同于电网调度控制系统、配电白动化系统及其他与电力牛产运行相关的应用软件的设计开发、测试验证、升级收造等【作，厂站监控系统可参照执行、2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡足注日期的引川文件，仅注口期的版本适川于本文件：凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件，GB/T12991.1信息技术数库语言SQL第1部分：框架（ISO/IEC9075-1，IDT）GB/T30149电网通川模型描述规范ISO/1HC 9075-2Infornation lechnology—Databasc languages—SQL—Part 2: FoundationISO/LEC 9075-3Inforination technology—Database languages—SQL—Part 3: Call-Level Interfacc3术语和定义
下列术语和定义适用于本标准。3.1
应用application
在电力系统应用软件中，用十完成特定任务、五相紧密关联的组功能集合，包括稳态监控应用，网络分析应月、白动发电控制应月等。3.2
态context
在电力系统应川软件，用丁描述应币的运行环境，通常与时间相关，包括实时态、研究态、规划态、测试态、反演态、培训态等。每个态中包含组成用集介，如实时态中可包含稳态监控应用和网络分析应用等。
实时数据real-timcdata
不断更新、对处埋实时性要求较高的数据，川于电力系统实时监视、控制和分析计算等、3.4
时间序列数据time-seriesdatal带有时间顺序标记或接照时间顺序排列的数制，能够反映乐物随时间变化的情况，适合描述中网运行动态或誓态过程，简称时序数据3.5
关系型数据rulationaldata
可表尔为关系数学模型行列一维表的数据，主要门于保存告警、非件记录、采样数抵、统分析等大批历史数据，也用月于保存电网模型、系统配置等其他数据，巾关系数据库进行存诺与管理。DL/ T 1456 — 2015
4缩略语
下列缩略语适用丁本标准。
sQL：结构化查询语言（structurcdquerylanguagc）。DCJ：数据库访问接1（dalabasccall interfacc）CIM/E：基于E的CIM模型（EhascdCIMmodcl)。数据库功能和类型
电力系统的实时数据左、时间序列实时数据库、时间序列历史数据库和关系数据库应通过本标准定义的逆用访问接口，为中力系统软件提供数据访问和管理功能，其技术要求如下：a）实时数错库应提供稳态实时数据的高效存取功能，支持心网运行实时监视和分析计算b）时序列实时数据库应提供实时断面数据的高速访问功能，支持对电网运行动态过程的监视与在:线分析计算。
时间序列历史数据库应提供时间序列数据的高效压缩归档与快速查询功能，支持对电网运行动c
态过程的历史重演与离线分析计算。关系数据库应提供历业采样数据，各类业务模型利历史数据等非实时数据的存储功能，适d
数据保存时间长、实时性不高的场合。数据库通用访问接口小所使川的基本数据炎型是表1。表1基本数据类型
STRING
字符型数捐，长度一个字节
先符号字符型数拼，长度一个字节字符审，明时指定长度
带号双节整数
带符号四字数
无符号双宁节整数
光符号四字市数
单精度四字浮点数
内存缓冲区
内行缓冲区地址
数据库通川访间接1使用的数据结构描述见表2，只体定义见附录~附录C。表2数据结构描述
数据结构名称
RIDB_TB DESCR
RTDB_TABLF_PARA STRU
WRDH IESCR
WRDB POINTCONFIG
中文名称
表撤述符
表信息钻构
连接描述符
测点结构
定义实讨数据库小的数撕表
定义实耐数据库数据表的各类属性定义时间列实时数据库的连接信息和连接状态定义时间序例实时数据库中数据测点的信息数铅结构名称
WHDB DESCR
WHDB MEASUREMENT CONFIG
WHDB_VALLE
WHDB DIGVALUE
表２（续）
中文名称
库描述符
测点配置结构
遥测量结构
避信量结构
DL/T 1456
定义时间序刻历史数额库的连接信息和连接状态定义时间序列历史数据库的测点配胃信息定义时问序列历史数拼床的遥测量信息定义时间学列历史数据库的信量信息附录D定义了关系数据库DCI接口归使的句柄及描述符。实时数据库访问接口
访问接口功能
实时数据库访问接口应支持以下功能：a）打开实时数据库表。
读取实时数据，支持全表读取、记录读取、表域读取：读取数据字典，包括表属性利表域属性。更新实时数据，包括表域数据史新和记录史新。插入、删除和清字实时数据库表记录，d)
关闭、删除实时数据库表。
支持通过SOL语句读取、操作实时数据，SOL语何的格式应遵循GB/T12991.1和ISO/IEC9075-2的规定。
实时数据库访问接口应是线程安全的，应至少提供表3所列的访问接门。表3实时数据库主要访问接口
接1名
CrcateTable
Open TableByNanc
GetTablcPara
GetFieldsPara
ClearTable
CloseTable
DrupTable
GetlableRecs
GetTableFields
GiFieldsByID
GetRecByD
GictRcesHyln
InsertRecs
UpdateRccBylD
UpdateRecsByID
创建装
按名称打开数热长
读取表参数
读取表域参数
清空记录
关阅数据表
删除表
读全表记求
读表的个或多个表域数据
通过关了读。条记录的一个或多个表域通过关键字读一条记录
通过关锭字试多条记录
拓入条或老条记录
通过关键宁更新条记录
道过关键字批量更新多条记录
DL/T1456--2015
UpdateFieldsByID
DeleteRecByID
DeleeRecsByID
ManipulateData BySql
Gel ValucAnclStalus
访问接口定义
接口返回值
表3（续）
通过关键更新一条记录·个戒多个表域过关键字删除条记录
通过关键子批量删除多条记求
接SQL语句的方式操纵记录
读测点的数查和状态
实时数据库访间接！的返回值般为INT4类型，应至少支持表4所列的返回值表4实时数据库访问接口返回值
返间俏
ERR_PSWD_FRR
ERR _RTDB_PARA
ERR_RTDB_MEMORY
ERR RTDB_INVSIZE
ERR RTDB INVKEY
ERR_RTD KEYFLEN
ERR_RTDB_EXISTREC
ERR_RIDB_NEXISTREC
ERR_RIDB_EMPTY
ERR RTDB DBFULL
FRR RTDB TABLE_STA
TRR_RTDBSQL
ERR RIIR FIELD_ NO
ERR_RTDB_TABLE_NO
ERR RTIH APP NO
ERR RTTB CONTEXT_NO
ERR HOST_INVALID
ERR_RTDB_EXISTTAB
ERR_ DUP_RECORI)
6.2.2创建表 CreateTable
接11原型：
执行止确
错误的用户名或11令
非法或者异常的参数
分配内存时汕错
缀冲大小错误
作法的关健字
关德字长度铅误
记录山存在
记求不存在
数据长没有数据
表小数据达到容量上限
数据表状态异带
非法的SQL语句
非法的域标识
非法的数据表标识
非法的应用标识
非法的态标识
连接位置销误
表己存在
存在武复记录
CreateTable(table_para
field.para
passwd
RETURNSINT4
INRTDB TABLEPARA STRU.
INMEM,
STRING
STRING
表属性
表属性
DL/T1456—2015
用广口令或数字沁书
注：引用自1SO/IEC9075-3的规定，CrcatcTable为接名称，tablepara、ficldpara、user和passwd为接|的参数名称，IN、OUT和INOUT为输入参数、输山签数和输入/输山参数，RTJHTABLEPARASIRL，MEM和STRING为参数的数概类型，双辩柜历的内容为参数描述，以下同。RTIB_TABLEPARA_STRU的详细数据结构说明见附录A.
功能描述：创建一张数据表。
返值说明：执行成功返向DBOK，执行错误时可能的返叫值包括LRRRIPBPARA、ERRRTDBMEMORY、ERRRTDBEXISTIAB等6.2.3按名称打开表OpenTableByNamc接门原型：
OpenTableByName(host_name
conlext name
app name
table aime
passwd
th descr
RETURNS TNT4
STRING,
STRING,
STRING,
STRING
STRING,
STRING,
R'TDB. TB DESCR
注：RFDBTBDESCR的详细数据结构说明见附录A动能描述：按名称打开表。
1表所在的主机
1表所属的态标识
表所属的成用标识
拥户名
/用户1:令或数了证15
/表描遂符
返回值说明：执行成功返回DBOK，执行错误时可能的返值包括ERRRTDBPARA、ERRRTDBMEMORY、ERRRTDB_TABLENO.ERRRTDB_APPNO、ERRRTDBCONTEXTNO、ERRHOSTINVALID、ERR_PSWDERR等。6.2.4读取表参数GetTablePara
接原型：
Gct'lablePara ( th descr
tablepara
RETURNS INT4
RTDB TBDESCR,
RTDR TAHLE PARA STRI:
功能述：读取表参数，获取数据表的可访问属性。发表描述欲
/表参数信息
返川值说明：执行成功返叫DBOK，执行错谈时可能的返回值色括ERRRIDBPARA、ERRRTDB MEMORY、LRR RTDB TABLE STA 等。6.2.5读取表域参数GetFieldsPara接口原型：
GetFieldsPara ( th_dcser
field para
RTDB TBDESCR
召表拥述符
予返的表域属性数据地址
DL/T1456-2015
RETURNS INT4
功能描述：读取表域参数，获取数据表域的可访问属性，返回值说明：执行成功返回衣域信息具体大小，执行错误时可能的返回值包括ERRRTDB_PARA，ERRRTDBMEMORY、ERR_RTDBTABLESTA等。6.2.6清空记录ClearTable
接口原型：
ClearTable ( tb_descr
passwd
RHTURNS INT4
RTDB_TB_DESCR，/表瑞述符
STRING,
STRING
洲广名
用广口令或数字证书
功能描述：消空记录，
返回值说明：热行成功返间DBOK，执行错误时可能的返值包括ERRRTDBPARA、ERRRTDB MLMORY、ERR RTIDH_TABLE STA、ERR PSWD ERR 等:6.2.7关闭数据表CloscTable
接口原型：
ClaseTable ( tb_descr
RFTUIRNS INT4
RTDB TB_DESCR
表描述符
功能描述：关闭数据表。
返回值说明：执行成功返同DBOK，执行错误时可能的返回值括ERRRTDBPARA、ERRRTDB_MEMORY 等。
6.2.8删除数据表DropTable
接口原型：
Dropfable ( th. descr
passwd
RFTURNSINT4
功能描述：删除一张数据表。
RTDB TB_DESCR,
STRING
/表描述符
洲户名
用广令或数字证传
返回值说明：执行成功返DBOK，执行错误时能的返n值包括ERRRTDBPARA、ERR_RTDBMHMORY、ERR RTDB TABI.E_STA、ERR_PSWD ERR 等6.2.9读取全表记录GetTableRecs接原型：
GetTableRecs ( tb descr
huf size
data_buffer
RETLRNS TNT4
RTDBTB_DESCR，表捕述符
问的数据长度
返同的数据地地：
功能描述：读取数据表全部记录数据，返回值说明：执行成功返问获取数据缓冲的具体大小，执行错误时可能的返回值包括ERRRTDB PARA、ERR RTDR_MEMORY、FRR RTDB TABLE STA、ERR RTDH EMPTY等.6
6.2.10读取表域数据GetTableFields接口原型：
GetTableFields (th descr
qucry_fields
buf_size
data buffer
RETURNSINT4
功能描述：读表的：“个或多个表域数据。RTDB_TB_DESCR、装揽述符
STRING,
被查询的表域名
/返回的数据长度
/返回的数据地址
DL/T1456— 2015
返回值说明：执行成功获取数据缓冲的其体人小，执行错误时能的返回值包括ERRRTDB_PARA、ERR RTDB MEMORY、ERR RTDB TABL.E STA、ERR RTDB FIELD NO、ERR RTDB HMPTY 等。6.2.11按关键字读取表域数据GetFieldsByl接』「原型：
GetFieldsByID (tb_ descr
keyword
query_ficlds
hur_size
data buffer
RETURNS INT4
RTIBTBDESCR，/表描述符
功能描述：通过关键字读一条记录的·个或多个表域数据，/用来查询的关键字
被查询的表域名
/返同的数据长度
/返同的数据地址
返回值说明：执行成功返叫DBOK，执行错误时训能的邀回值包括LRR_RTDBPARA、ERRRTDB_MEMORY、LRR RTDB_TABLHSTA、ERR_RTDB_FIELDNO、ERR_RTDB INVSIZE、ERRRTDBNEXIST'REC、ERRRTDBINVKEY等6.2.12按关键字读取一条记录GetRecByID接」「原型：
GelRecByID ( th desur
keyword
buf_size
data buffer
RETURNS INT4
功能措述：通过关键字读-条记录RTDB_TB ESCR，表描述符
用来否询的关键子
/返回的数据长度
/返回的数据地址
返回值说明：执行成功返回DBOK，执行错误时可能的返回值包括ERRRTDBPARA、ERRRTDB_MEMORY、ERR_RTDB TABLE_STA、HRR RTDB INVSIZE、HRR RTDB NEXISTREC、ERRRIDB_INVKEY 等。
6.2.13按关键字读取多条记录GetRecsBylD接原型：
GetReesBylD( tb descr
keyword
key num
buf size
data buffer
RTDB_TB_1ESCR、1表描述符
用来食的关键字
/用来食询的关键字个数
返回的数据长度
返回的数据地址
DL/T1456—2015
RETL:RNS INT4
功能描述：逆过单个或多个关键字读取多条记录返回值说明：执行成功返回DBOK，执行错误时可能的返川值包括ERRRTIDBPARA，ERR RIDB MEMORY、ERR RTDB_TABLE STA.ERR_RTDB INVSIZE、EFR_RTDB_NEXISTREC、ERR RIDB INVKEY 等.
6.2.14插入一条或多条记录InscrtRecs接口原型：
InsertRecs ( tb_dcscr
rec_nun
luf size
data buffer IN
RFTRNS INT4
RTDBTB DESCR，表捕述符
/捆入的记录个数
拆入的数据长度
插入的数据内容
功能描述：插入，条或多条记录、返回值说明：执行成功返IDHOK，执行错误时可能的返值包括ERRRIDBPARA，ERR RIDB MEMORY、HRR RTDB TABLE STA、ERR_RTDB INVSIZE、ERR RTDB_INVKEY、ERR RTDB EXISTREC 等:
6.2.15按关键字更新一条记录UpdateRecByID接口原型：
UpdateRecByID (th deser
keyward
buf_sizc
dau_buffer
RETURNS INT4
功能描述：通过关键字更新条记录。RTDR_ TB _DESCR.
装递符
/更新记求的关键宁
史更新的激据长度
/更新的数据内容
返川值说明：执行成功返尚DBOK，执行错误时可能的返值包括ERR_RTDBPARA、ERRRTDB MEMORY、FRR RTDB TABILE STA、ERR RIIH INVSIZE、ERR RIIDB NEXISTREC、HRRRTDB_INVKEY等。
6.2.16按关键字批量更新记录UpdateRecsByID接口原型：
UpdateRecsByID (th desur
keyword
key_num
bur_size
data buffer
REIL:RNS INT4
功能描述：通过关键字批量史新记录：RTDB_TR_DESCR，/表描述符
/批量双新的关健字结构
1/更新记录的炎键宁个数
用了更新的数据长成
/用了更新的数据
返叫值说明：执行成功返叫DBOK，执行错误时可能的邀回值包括ERRRTDBPARA、ERRRIDB MEMORY、ERR RTDB TABIE STA、ERR RTDBINVSIZL、LRRRTDB NEXISTREC、ERRRTDB INVKEY 等。
6.2.17按关键字更新一条记录的表域数据UpdateFieldsBylD接口原型：
UpdatFieldsByID( tb descr
keyword
updalc_fields
huf_size
dala bufter
RETITRNS INT4
RTDB_TBI>ESCR、装描述符
/更新记录的关健学
/史新的表域名
/更新的数据长度
7更新的数据内窄
功能描述：通过关键字更新一条记录的一个或多个表域数据DL/T1456—2015
返值说明：热行成功返DBOK，执行错误时可能的返向值包括ERRRIDBPARA、ERRRIDB MEMORY、ERR RIDB TAHLE STA、HRR RTDB INVSIZE、ERR_RTDB NEXISTREC、ERRRTDB_INVKEY、ERR DUP RLCORD 等：6.2.18按关键字删除一条记录DeleteRccByID接原型：
DeleteRecBylD ( tb deser
keywurd
RETURNS INT4
功能拍述：通过关键字删除一条记求，RTDB_TB_DESCR
1表描述符
删除记求的关键宁
返回值说明：执行成功返回DBOK，执行错误时可能的返回值包括ERRRTDBPARA、ERRRTDBMEMORY、ERRRTDB_TABLESTA.ERRRTDB_NEXISTREC.ERRRTDBINVKEY等6.2.19按关键字批量删除记录DeleteRecsByID接原
DeleteRecsBylD( tb descr
keyword
key_num
RETURNS INT4
动能描述：通过关键字批量删除记录。RTDBTB_DESCR表述符
批量删除记录的关键字结构
删除记录的个数
返川值说明：执行成功返回DBOK，执行错误时可能的返回值包括ERRRIDBPARA、ERR RTDB_MEMORY、LRR_RIDB TABLE STA、ERR RTDB NEXISTREC、ERR RTDB INVKEY 等.6.2.20以SQL语句的方式操纵记录ManipulateDataBySq接」「原狸：
ManipulateDataBySql (tb_descrsql_st
sql iypc
buf size
data butler
RETURNS INT4
RTDBTBDESCR，1表描述符
STRING,
INT2、
操纵记录的SQL语句
I/SQL语句的类型
返回的记求数据长度
返同的记求数据地址
注：SQL谐句的类型应支持查询、入和更新+不应支持删除。查询类型的SQ1，语句支持带whre证句的简单过溉查询，至少应包括一、、》、、、α、like.
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。
备案号：50776-2015
中华人民共和国电力行业标准
DL/T1456—2015
电力系统数据库通用访问接口规范General call interface specification of database for electric power system2015-07-01发布
国家能源局
2015-12-01实施
规范性引用文件
术语和定义…
缩略语
5数据库功能和炎型
6实时数据库访问接口
7时间序列实时数据库访问接口
8时间序列历史数据库访问接口
9关系数据库访问接「」（DCI）目bzxZ.net
附录A（规范性附录）室
实时数据库访问接口数据结构
附录B（规范性附录）【
时闻序列实时数据访问接数粘结构附录C（规范性附录）时问序列历史数据库访问接口数据结构附录D（规范性附录）关系数据库访问接口（DCI）山使用的句柄及描述符DL/T1456
DL/T1456—2015
为规范电网调度控制系统、配电动化系统等应用软件对各类数据库的访问接口，指导相关系统及其应用功能的设计开发、测试验证利升级改造，制定本标准。本标准按照GB/1'1.1-2009《标准化工作则第1部分：标准的结构和编写》给出的规则起草：本标准由中国电力企业联介会提山：本标准由全国中网运行与控制标准化技术委员会（SAC/IC446）归口。本标准起节单位：南京南瑞集闭公司、国家电网公司国家电力调度控制中心、南方中网有限责任公司电力调度控制中心、中国中力科学研究院、北京四方继保自动化股份有限公司、武汉达梦数据库有限公司、北京人大金仓信息技术股份有限公司、家电网公削华中分部、网江苏省电力公司、国网江匹省电力公司、国网浙江省电力公司。本标准主要起草人：严亚勤、梁寿总、翼明下、瀚洪倚、彭晖、陈鹏、张伟、葛云鹏、1瑾、吴庆曦谢晓冬、张杰、李海华、马志斌、厉鹏、花静、李宇仕、闺湖、詹庆才、刘涛、金学成、徐存需、古震滨、于宏文。
本标准在执行过程的意见或建议请反馈至国电力企业联合会标准化管理心（北京市自）路一条—号，100761)。
1范围
电力系统数据库通用访问接口规范DL/T1456
本标准规定了电力系统实时数据库、时间序列实时数据库、时问序列历史数据库利关系数据库的通川访问接1「，明确了接口功能和参数定义等技术要求。本标准适同于电网调度控制系统、配电白动化系统及其他与电力牛产运行相关的应用软件的设计开发、测试验证、升级收造等【作，厂站监控系统可参照执行、2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡足注日期的引川文件，仅注口期的版本适川于本文件：凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件，GB/T12991.1信息技术数库语言SQL第1部分：框架（ISO/IEC9075-1，IDT）GB/T30149电网通川模型描述规范ISO/1HC 9075-2Infornation lechnology—Databasc languages—SQL—Part 2: FoundationISO/LEC 9075-3Inforination technology—Database languages—SQL—Part 3: Call-Level Interfacc3术语和定义
下列术语和定义适用于本标准。3.1
应用application
在电力系统应用软件中，用十完成特定任务、五相紧密关联的组功能集合，包括稳态监控应用，网络分析应月、白动发电控制应月等。3.2
态context
在电力系统应川软件，用丁描述应币的运行环境，通常与时间相关，包括实时态、研究态、规划态、测试态、反演态、培训态等。每个态中包含组成用集介，如实时态中可包含稳态监控应用和网络分析应用等。
实时数据real-timcdata
不断更新、对处埋实时性要求较高的数据，川于电力系统实时监视、控制和分析计算等、3.4
时间序列数据time-seriesdatal带有时间顺序标记或接照时间顺序排列的数制，能够反映乐物随时间变化的情况，适合描述中网运行动态或誓态过程，简称时序数据3.5
关系型数据rulationaldata
可表尔为关系数学模型行列一维表的数据，主要门于保存告警、非件记录、采样数抵、统分析等大批历史数据，也用月于保存电网模型、系统配置等其他数据，巾关系数据库进行存诺与管理。DL/ T 1456 — 2015
4缩略语
下列缩略语适用丁本标准。
sQL：结构化查询语言（structurcdquerylanguagc）。DCJ：数据库访问接1（dalabasccall interfacc）CIM/E：基于E的CIM模型（EhascdCIMmodcl)。数据库功能和类型
电力系统的实时数据左、时间序列实时数据库、时间序列历史数据库和关系数据库应通过本标准定义的逆用访问接口，为中力系统软件提供数据访问和管理功能，其技术要求如下：a）实时数错库应提供稳态实时数据的高效存取功能，支持心网运行实时监视和分析计算b）时序列实时数据库应提供实时断面数据的高速访问功能，支持对电网运行动态过程的监视与在:线分析计算。
时间序列历史数据库应提供时间序列数据的高效压缩归档与快速查询功能，支持对电网运行动c
态过程的历史重演与离线分析计算。关系数据库应提供历业采样数据，各类业务模型利历史数据等非实时数据的存储功能，适d
数据保存时间长、实时性不高的场合。数据库通用访问接口小所使川的基本数据炎型是表1。表1基本数据类型
STRING
字符型数捐，长度一个字节
先符号字符型数拼，长度一个字节字符审，明时指定长度
带号双节整数
带符号四字数
无符号双宁节整数
光符号四字市数
单精度四字浮点数
内存缓冲区
内行缓冲区地址
数据库通川访间接1使用的数据结构描述见表2，只体定义见附录~附录C。表2数据结构描述
数据结构名称
RIDB_TB DESCR
RTDB_TABLF_PARA STRU
WRDH IESCR
WRDB POINTCONFIG
中文名称
表撤述符
表信息钻构
连接描述符
测点结构
定义实讨数据库小的数撕表
定义实耐数据库数据表的各类属性定义时间列实时数据库的连接信息和连接状态定义时间序例实时数据库中数据测点的信息数铅结构名称
WHDB DESCR
WHDB MEASUREMENT CONFIG
WHDB_VALLE
WHDB DIGVALUE
表２（续）
中文名称
库描述符
测点配置结构
遥测量结构
避信量结构
DL/T 1456
定义时间序刻历史数额库的连接信息和连接状态定义时间序列历史数据库的测点配胃信息定义时问序列历史数拼床的遥测量信息定义时间学列历史数据库的信量信息附录D定义了关系数据库DCI接口归使的句柄及描述符。实时数据库访问接口
访问接口功能
实时数据库访问接口应支持以下功能：a）打开实时数据库表。
读取实时数据，支持全表读取、记录读取、表域读取：读取数据字典，包括表属性利表域属性。更新实时数据，包括表域数据史新和记录史新。插入、删除和清字实时数据库表记录，d)
关闭、删除实时数据库表。
支持通过SOL语句读取、操作实时数据，SOL语何的格式应遵循GB/T12991.1和ISO/IEC9075-2的规定。
实时数据库访问接口应是线程安全的，应至少提供表3所列的访问接门。表3实时数据库主要访问接口
接1名
CrcateTable
Open TableByNanc
GetTablcPara
GetFieldsPara
ClearTable
CloseTable
DrupTable
GetlableRecs
GetTableFields
GiFieldsByID
GetRecByD
GictRcesHyln
InsertRecs
UpdateRccBylD
UpdateRecsByID
创建装
按名称打开数热长
读取表参数
读取表域参数
清空记录
关阅数据表
删除表
读全表记求
读表的个或多个表域数据
通过关了读。条记录的一个或多个表域通过关键字读一条记录
通过关锭字试多条记录
拓入条或老条记录
通过关键宁更新条记录
道过关键字批量更新多条记录
DL/T1456--2015
UpdateFieldsByID
DeleteRecByID
DeleeRecsByID
ManipulateData BySql
Gel ValucAnclStalus
访问接口定义
接口返回值
表3（续）
通过关键更新一条记录·个戒多个表域过关键字删除条记录
通过关键子批量删除多条记求
接SQL语句的方式操纵记录
读测点的数查和状态
实时数据库访间接！的返回值般为INT4类型，应至少支持表4所列的返回值表4实时数据库访问接口返回值
返间俏
ERR_PSWD_FRR
ERR _RTDB_PARA
ERR_RTDB_MEMORY
ERR RTDB_INVSIZE
ERR RTDB INVKEY
ERR_RTD KEYFLEN
ERR_RTDB_EXISTREC
ERR_RIDB_NEXISTREC
ERR_RIDB_EMPTY
ERR RTDB DBFULL
FRR RTDB TABLE_STA
TRR_RTDBSQL
ERR RIIR FIELD_ NO
ERR_RTDB_TABLE_NO
ERR RTIH APP NO
ERR RTTB CONTEXT_NO
ERR HOST_INVALID
ERR_RTDB_EXISTTAB
ERR_ DUP_RECORI)
6.2.2创建表 CreateTable
接11原型：
执行止确
错误的用户名或11令
非法或者异常的参数
分配内存时汕错
缀冲大小错误
作法的关健字
关德字长度铅误
记录山存在
记求不存在
数据长没有数据
表小数据达到容量上限
数据表状态异带
非法的SQL语句
非法的域标识
非法的数据表标识
非法的应用标识
非法的态标识
连接位置销误
表己存在
存在武复记录
CreateTable(table_para
field.para
passwd
RETURNSINT4
INRTDB TABLEPARA STRU.
INMEM,
STRING
STRING
表属性
表属性
DL/T1456—2015
用广口令或数字沁书
注：引用自1SO/IEC9075-3的规定，CrcatcTable为接名称，tablepara、ficldpara、user和passwd为接|的参数名称，IN、OUT和INOUT为输入参数、输山签数和输入/输山参数，RTJHTABLEPARASIRL，MEM和STRING为参数的数概类型，双辩柜历的内容为参数描述，以下同。RTIB_TABLEPARA_STRU的详细数据结构说明见附录A.
功能描述：创建一张数据表。
返值说明：执行成功返向DBOK，执行错误时可能的返叫值包括LRRRIPBPARA、ERRRTDBMEMORY、ERRRTDBEXISTIAB等6.2.3按名称打开表OpenTableByNamc接门原型：
OpenTableByName(host_name
conlext name
app name
table aime
passwd
th descr
RETURNS TNT4
STRING,
STRING,
STRING,
STRING
STRING,
STRING,
R'TDB. TB DESCR
注：RFDBTBDESCR的详细数据结构说明见附录A动能描述：按名称打开表。
1表所在的主机
1表所属的态标识
表所属的成用标识
拥户名
/用户1:令或数了证15
/表描遂符
返回值说明：执行成功返回DBOK，执行错误时可能的返值包括ERRRTDBPARA、ERRRTDBMEMORY、ERRRTDB_TABLENO.ERRRTDB_APPNO、ERRRTDBCONTEXTNO、ERRHOSTINVALID、ERR_PSWDERR等。6.2.4读取表参数GetTablePara
接原型：
Gct'lablePara ( th descr
tablepara
RETURNS INT4
RTDB TBDESCR,
RTDR TAHLE PARA STRI:
功能述：读取表参数，获取数据表的可访问属性。发表描述欲
/表参数信息
返川值说明：执行成功返叫DBOK，执行错谈时可能的返回值色括ERRRIDBPARA、ERRRTDB MEMORY、LRR RTDB TABLE STA 等。6.2.5读取表域参数GetFieldsPara接口原型：
GetFieldsPara ( th_dcser
field para
RTDB TBDESCR
召表拥述符
予返的表域属性数据地址
DL/T1456-2015
RETURNS INT4
功能描述：读取表域参数，获取数据表域的可访问属性，返回值说明：执行成功返回衣域信息具体大小，执行错误时可能的返回值包括ERRRTDB_PARA，ERRRTDBMEMORY、ERR_RTDBTABLESTA等。6.2.6清空记录ClearTable
接口原型：
ClearTable ( tb_descr
passwd
RHTURNS INT4
RTDB_TB_DESCR，/表瑞述符
STRING,
STRING
洲广名
用广口令或数字证书
功能描述：消空记录，
返回值说明：热行成功返间DBOK，执行错误时可能的返值包括ERRRTDBPARA、ERRRTDB MLMORY、ERR RTIDH_TABLE STA、ERR PSWD ERR 等:6.2.7关闭数据表CloscTable
接口原型：
ClaseTable ( tb_descr
RFTUIRNS INT4
RTDB TB_DESCR
表描述符
功能描述：关闭数据表。
返回值说明：执行成功返同DBOK，执行错误时可能的返回值括ERRRTDBPARA、ERRRTDB_MEMORY 等。
6.2.8删除数据表DropTable
接口原型：
Dropfable ( th. descr
passwd
RFTURNSINT4
功能描述：删除一张数据表。
RTDB TB_DESCR,
STRING
/表描述符
洲户名
用广令或数字证传
返回值说明：执行成功返DBOK，执行错误时能的返n值包括ERRRTDBPARA、ERR_RTDBMHMORY、ERR RTDB TABI.E_STA、ERR_PSWD ERR 等6.2.9读取全表记录GetTableRecs接原型：
GetTableRecs ( tb descr
huf size
data_buffer
RETLRNS TNT4
RTDBTB_DESCR，表捕述符
问的数据长度
返同的数据地地：
功能描述：读取数据表全部记录数据，返回值说明：执行成功返问获取数据缓冲的具体大小，执行错误时可能的返回值包括ERRRTDB PARA、ERR RTDR_MEMORY、FRR RTDB TABLE STA、ERR RTDH EMPTY等.6
6.2.10读取表域数据GetTableFields接口原型：
GetTableFields (th descr
qucry_fields
buf_size
data buffer
RETURNSINT4
功能描述：读表的：“个或多个表域数据。RTDB_TB_DESCR、装揽述符
STRING,
被查询的表域名
/返回的数据长度
/返回的数据地址
DL/T1456— 2015
返回值说明：执行成功获取数据缓冲的其体人小，执行错误时能的返回值包括ERRRTDB_PARA、ERR RTDB MEMORY、ERR RTDB TABL.E STA、ERR RTDB FIELD NO、ERR RTDB HMPTY 等。6.2.11按关键字读取表域数据GetFieldsByl接』「原型：
GetFieldsByID (tb_ descr
keyword
query_ficlds
hur_size
data buffer
RETURNS INT4
RTIBTBDESCR，/表描述符
功能描述：通过关键字读一条记录的·个或多个表域数据，/用来查询的关键字
被查询的表域名
/返同的数据长度
/返同的数据地址
返回值说明：执行成功返叫DBOK，执行错误时训能的邀回值包括LRR_RTDBPARA、ERRRTDB_MEMORY、LRR RTDB_TABLHSTA、ERR_RTDB_FIELDNO、ERR_RTDB INVSIZE、ERRRTDBNEXIST'REC、ERRRTDBINVKEY等6.2.12按关键字读取一条记录GetRecByID接」「原型：
GelRecByID ( th desur
keyword
buf_size
data buffer
RETURNS INT4
功能措述：通过关键字读-条记录RTDB_TB ESCR，表描述符
用来否询的关键子
/返回的数据长度
/返回的数据地址
返回值说明：执行成功返回DBOK，执行错误时可能的返回值包括ERRRTDBPARA、ERRRTDB_MEMORY、ERR_RTDB TABLE_STA、HRR RTDB INVSIZE、HRR RTDB NEXISTREC、ERRRIDB_INVKEY 等。
6.2.13按关键字读取多条记录GetRecsBylD接原型：
GetReesBylD( tb descr
keyword
key num
buf size
data buffer
RTDB_TB_1ESCR、1表描述符
用来食的关键字
/用来食询的关键字个数
返回的数据长度
返回的数据地址
DL/T1456—2015
RETL:RNS INT4
功能描述：逆过单个或多个关键字读取多条记录返回值说明：执行成功返回DBOK，执行错误时可能的返川值包括ERRRTIDBPARA，ERR RIDB MEMORY、ERR RTDB_TABLE STA.ERR_RTDB INVSIZE、EFR_RTDB_NEXISTREC、ERR RIDB INVKEY 等.
6.2.14插入一条或多条记录InscrtRecs接口原型：
InsertRecs ( tb_dcscr
rec_nun
luf size
data buffer IN
RFTRNS INT4
RTDBTB DESCR，表捕述符
/捆入的记录个数
拆入的数据长度
插入的数据内容
功能描述：插入，条或多条记录、返回值说明：执行成功返IDHOK，执行错误时可能的返值包括ERRRIDBPARA，ERR RIDB MEMORY、HRR RTDB TABLE STA、ERR_RTDB INVSIZE、ERR RTDB_INVKEY、ERR RTDB EXISTREC 等:
6.2.15按关键字更新一条记录UpdateRecByID接口原型：
UpdateRecByID (th deser
keyward
buf_sizc
dau_buffer
RETURNS INT4
功能描述：通过关键字更新条记录。RTDR_ TB _DESCR.
装递符
/更新记求的关键宁
史更新的激据长度
/更新的数据内容
返川值说明：执行成功返尚DBOK，执行错误时可能的返值包括ERR_RTDBPARA、ERRRTDB MEMORY、FRR RTDB TABILE STA、ERR RIIH INVSIZE、ERR RIIDB NEXISTREC、HRRRTDB_INVKEY等。
6.2.16按关键字批量更新记录UpdateRecsByID接口原型：
UpdateRecsByID (th desur
keyword
key_num
bur_size
data buffer
REIL:RNS INT4
功能描述：通过关键字批量史新记录：RTDB_TR_DESCR，/表描述符
/批量双新的关健字结构
1/更新记录的炎键宁个数
用了更新的数据长成
/用了更新的数据
返叫值说明：执行成功返叫DBOK，执行错误时可能的邀回值包括ERRRTDBPARA、ERRRIDB MEMORY、ERR RTDB TABIE STA、ERR RTDBINVSIZL、LRRRTDB NEXISTREC、ERRRTDB INVKEY 等。
6.2.17按关键字更新一条记录的表域数据UpdateFieldsBylD接口原型：
UpdatFieldsByID( tb descr
keyword
updalc_fields
huf_size
dala bufter
RETITRNS INT4
RTDB_TBI>ESCR、装描述符
/更新记录的关健学
/史新的表域名
/更新的数据长度
7更新的数据内窄
功能描述：通过关键字更新一条记录的一个或多个表域数据DL/T1456—2015
返值说明：热行成功返DBOK，执行错误时可能的返向值包括ERRRIDBPARA、ERRRIDB MEMORY、ERR RIDB TAHLE STA、HRR RTDB INVSIZE、ERR_RTDB NEXISTREC、ERRRTDB_INVKEY、ERR DUP RLCORD 等：6.2.18按关键字删除一条记录DeleteRccByID接原型：
DeleteRecBylD ( tb deser
keywurd
RETURNS INT4
功能拍述：通过关键字删除一条记求，RTDB_TB_DESCR
1表描述符
删除记求的关键宁
返回值说明：执行成功返回DBOK，执行错误时可能的返回值包括ERRRTDBPARA、ERRRTDBMEMORY、ERRRTDB_TABLESTA.ERRRTDB_NEXISTREC.ERRRTDBINVKEY等6.2.19按关键字批量删除记录DeleteRecsByID接原
DeleteRecsBylD( tb descr
keyword
key_num
RETURNS INT4
动能描述：通过关键字批量删除记录。RTDBTB_DESCR表述符
批量删除记录的关键字结构
删除记录的个数
返川值说明：执行成功返回DBOK，执行错误时可能的返回值包括ERRRIDBPARA、ERR RTDB_MEMORY、LRR_RIDB TABLE STA、ERR RTDB NEXISTREC、ERR RTDB INVKEY 等.6.2.20以SQL语句的方式操纵记录ManipulateDataBySq接」「原狸：
ManipulateDataBySql (tb_descrsql_st
sql iypc
buf size
data butler
RETURNS INT4
RTDBTBDESCR，1表描述符
STRING,
INT2、
操纵记录的SQL语句
I/SQL语句的类型
返回的记求数据长度
返同的记求数据地址
注：SQL谐句的类型应支持查询、入和更新+不应支持删除。查询类型的SQ1，语句支持带whre证句的简单过溉查询，至少应包括一、、》、、、α、like.
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。