D5000商用数据库程序员手册.docx

D5000商用数据库程序员手册.docx

《D5000商用数据库程序员手册.docx》由会员分享，可在线阅读，更多相关《D5000商用数据库程序员手册.docx（24页珍藏版）》请在冰豆网上搜索。

D5000商用数据库程序员手册

1.历史数据访问服务

1.1客户端数据库调用接口Dci类

1.1.1连接数据库接口Connect

IntConnect（constchar*server,constchar*user_name,constchar*pasword,ErrorInfo_t*error）

1.1.1.1参数描述

表14-1

接口参数

输入输出

参数（返回值）说明

备注

server

IN

数据库服务名。

类似oracle中的tnsnames中描述的数据服务名。

user_name

IN

用户名。

pasword

IN

用户密码。

error

OUT

带有错误信息的结构。

返回值

OUT

正确返回True，错误返回False。

1.1.1.2处理过程及返回值说明

在需要和数据库交互时首先需要调用该接口进行连接工作，数据库客户端将用户名、密码等相关信息传递给服务器，连接数据库成功后该类将获得环境句柄evnhp，服务句柄svchp，错误句柄errhp，认证句柄authp。

其中evnhp、svchp、authp为全局变量。

并可以利用该类的其他接口进行和数据库的交互工作。

正确返回True，错误返回False。

错误结构中包括发生错误的文件名，发生错误的文件的行，数据库的返回的错误号，数据库返回的错误描述。

1.1.1.3调用方法

classCDcig_CDci；

Error_Infoerror;

IntRetcode;

Retcode=g_CDci.Connect（‘HIS’,‘hisdb’,‘hisdb’,error）;

1.1.2数据库断开连接DisConnect

DisConnect（ErrorInfo_t*error）

1.1.2.1参数描述

表14-2

接口参数

输入输出

参数（返回值）说明

备注

error

OUT

错误信息

返回值

OUT

1：

正确断开和数据库的连接情况。

0：

因各种原因没有正确结束。

1.1.2.2处理过程及返回值说明

在程序和数据库交互工作完成以后，需要通知数据库释放为该客户端链接所开的资源，调应该接口可以完成上述工作。

1.1.2.3调用方法

classCDcig_CDci;

Intretcode；

Retcode=g_CDci.DisConnect（error）;

1.1.3从商用库读取数据

1.1.3.1参数描述

intCDci:

:

ReadData（INconstchar*query,OUTint*rec_num,OUTint*attr_num,OUTstructColAttr**attrs,OUTchar**buf,ErrorInfo_t*error）

intCDci:

:

ReadData（INconstchar*query,INinttop_number,OUTint*rec_num,OUTint*attr_num,OUTstructColAttr**attrs,OUTchar**buf,ErrorInfo_t*error）

表14-3

接口参数

输入/输出

参数（返回值）说明

备注

query

In

Sql字符串执行命令

top_number

In

取数据集的前top_number行

如果为-1，则将符合条件的所有结果集缺省全部输出。

rec_num

out

返回应用的处于活动状态的机器名

attr_num

Out

返回应用的处于活动状态的机器号

attrs

Out

数据集各个属性的描述。

buf

Out

数据集的首指针

error

Out

错误结构

返回值

Out

1：

成功；0：

失败

1.1.3.2处理过程及返回值说明

通过该接口，数据库会根据query从数据库读取数据并返回相关数据，rec_num为返回的数据行数，attr_num为返回的属性的个数，attrs为返回的列属性数组的头指针，buf为按照先行后列规则排列的数据集合，error为接口返回错误结构，接口成功后error为空，接口失败后需要读取error的内容定位数据库错误。

和FreeReadData搭对应用，以便对内存进行释放。

1.1.3.3调用方法

classCDcig_CDci;

Intretcode；

Retcode=g_CDci.Connect（‘HIS’,’hisdb’,’hisdb’,error）;

Intrec_num,attr_num;

Char*attrs,*buf;

Retcode=g_CDci.ReadData（‘select*fromaaa’,&rec_num,&attr_num,&attrs,&buf,error）

If（Retcode!

=True）

{

Printf（“theerrornois%dandtheerrordescris%s“,error.error_no,error.error_info）;

}

Retcode=g_CDci.ReadData（‘select*fromaaa’,1000,&rec_num,&attr_num,&attrs,&buf,error）

If（Retcode!

=True）

{

Printf（“theerrornois%dandtheerrordescris%s“,error.error_no,error.error_info）;

}

1.1.4释放数据集列属性描述结构指针，通常和ReadData接口联合使用

1.1.4.1参数描述

voidCDci:

:

FreeColAttrData（ColAttr_t*col_attr,intcols）

表14-4

接口参数

输入/输出

参数（返回值）说明

备注

col_attr

In

列属性头指针的描述

cols

In

列个数

返回值

Out

1：

成功；0：

失败

1.1.4.2处理过程及返回值说明

在使用ReadData接口取数成功后，输入ReadData接口所开的列属性的头指针和列的个数，该接口会依次释放掉数据集合列属性集中所消耗内存，确保没有内存泄漏。

和GetColAttr接口搭对。

1.1.4.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

Retcode=g_CDci.ReadData（‘select*fromaaa’,&rec_num,&attr_num,&attrs,&buf,error）

If（Retcode!

=True）

{

Printf（“theerrornois%dandtheerrordescris%s“,error.error_no,error.error_info）;

}

Retcode=g_CDci.FreeColAttrData（attrs,attr_num,&error1）;

1.1.5释放数据集指针，通常和ReadData接口联合使用

1.1.5.1参数描述

voidCDci:

:

FreeReadData（ColAttr_t*col_attr,intcolnum,char*databuf）

表14-5

接口参数

输入/输出

参数（返回值）说明

备注

col_attr

In

列属性头指针的描述

colnum

In

列个数

databuf

In

数据集指针

返回值

Out

1：

成功；0：

失败

1.1.5.2处理过程及返回值说明

在使用ReadData接口取数成功后，输入ReadData接口所开的列属性的头指针和列的个数，输入返回的数据集的头指针，该接口会依次释放掉数据集合列属性集中所消耗内存，释放掉数据集所耗的内存，确保没有内存泄漏。

1.1.5.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

Retcode=g_CDci.ReadData（‘select*fromaaa’,&rec_num,&attr_num,&attrs,&buf,error）

If（Retcode!

=True）

{

Printf（“theerrornois%dandtheerrordescris%s“,error.error_no,error.error_info）;

}

Retcode=g_CDci.FreeReadData（attrs,attr_num,&error1）;

1.1.6执行sql语句

1.1.6.1参数描述

boolCDci:

:

ExecSingle（INconstchar*sqlstr,ErrorInfo_t*error）

表14-6

接口参数

输入/输出

参数（返回值）说明

备注

sqlstr

Out

可执行的sql语句

error

In

返回错误结构

返回值

Out

1：

成功；0：

失败

1.1.6.2处理过程及返回值说明

Sqlstr为可执行的sql语句，返回true为执行成功，返回false为执行失败。

1.1.6.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

retcode=g_CDci.ExecSingle（‘updateaaaseta1=5whereb1=6’,&error1）;

1.1.7插入或更新数据至数据库

1.1.7.1参数描述

boolCDci:

:

WriteData（INconstchar*query,INconstchar*buf,INconstintrec_num,INconstintattr_num,INconststructColAttr*attrs,ErrorInfo_t*error）

表14-7

接口参数

输入/输出

参数（返回值）说明

备注

query

Out

可执行的sql语句

buf

In

返回错误结构

rec_num

Out

记录行数

attr_num

Out

列属性的行数

attrs

Out

列属性结构指针

error

Out

错误结构指针

返回值

Out

1：

成功；0：

失败

1.1.7.2处理过程及返回值说明

数据库通过解析query，将buf为头指针的数据集合按照行和列属性的描述进行数据的回写。

1返回成功，0返回失败。

1.1.7.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

conststrutColAttr*attrs=（ColAttr*）malloc（sizeof（colattr_t）*2）;//有两列数据

attrs[0].data_type=DCI_INT;

attrs[0].data_size=4;

attrs[1].data_type=DCI_INT;

attrs[1].data_size=4;

charqurey[1000];

memset（query,0,1000）;

strcpy（query,’updateaaaseta1=3whereb1=5’）;

retcode=g_CDci.WriteData（query,buf,2,2,attrs,&error1）;

if（retcode!

=0）

{

Printf（“theerrorcodeis%dandthedescris%s“,error.error_no,error.error.error_info）;

}

1.1.8得到某条曲线的数据

1.1.8.1参数描述

intCDci:

:

GetCurveData（CurvePara¶m,CurveData**datapp,int&items,ErrorInfo&error）

表14-8

接口参数

输入/输出

参数（返回值）说明

备注

para

Out

曲线参数信息

结构包括：

charconf_id采样表定义的配置号；

Time_t:

starttime:

要求取得的启示时间；

Time_t:

stoptime:

要求取得的采样终点时间；

chardev_key_id_values:

keyid描述。

Intneedpace：

步长

Intdata_format:

要求得到数据的类型，是平均值还是最大、最小值等。

Charresvererd[32]:

保留字节。

datapp

In

返回错误结构

items

Out

曲线返回点个数

error

Out

错误结构

返回值

Out

1：

成功；0：

失败

1.1.8.2处理过程及返回值说明

通过解析param结构，获得曲线信息，包括曲线数据类型（最大值，最小值，第一个值，最后一个值，平均值）、数据时间间隔、曲线号（根据曲线号得到数据库表结构、数据集合和取数条件），将获得的数据存入CurveData类型的datapp指针指向的数据结构中，成功返回1，失败返回0。

1.1.8.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

if（retcode!

=0）

{

Printf（“theerrorcodeis%dandthedescris%s“,error.error_no,error.error.error_info）;

}

1.1.9得到某个表格的数据

1.1.9.1参数描述

intCDci:

:

GetSheetData（CurvePara¶m,vector&attr,vector&data,vector&colname,constchar*where_str,ErrorInfo&error）

表14-9

接口参数

输入/输出

参数（返回值）说明

备注

param

In

表格（曲线）参数信息

同GetCurveData接口描述。

结构包括：

charconf_id采样表定义的配置号；

Time_t:

starttime:

要求取得的启示时间；

Time_t:

stoptime:

要求取得的采样终点时间；

chardev_key_id_values:

keyid描述。

Intneedpace：

步长

Intdata_format:

要求得到数据的类型，是平均值还是最大、最小值等。

Charresvererd[32]:

保留字节。

attr

In

读取列信息的容器

data

Out

返回表格数据

colname

In

返回表格字符串

where_str

In

读取表格数据的过滤条件

error

Out

返回值

Out

1：

成功；0：

失败

1.1.9.2处理过程及返回值说明

通过解析param结构，获得表格信息，包括表格数据时间间隔、表格号（根据表格号得到数据库表结构、数据集合和取数条件），将获得的数据存入ColDataItem类型的data指针指向的数据结构中，成功返回1，失败返回0。

1.1.9.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

if（retcode!

=0）

{

Printf（“theerrorcodeis%dandthedescris%s“,error.error_no,error.error.error_info）;

}

g_CDci.GetSheetData（CurvePara¶m,vector&attr,vector&data,vector&colname,constchar*where_str,constchar*order_by,ErrorInfo&error）;

1.1.10从曲线上修改数据

1.1.10.1参数描述

intCDci:

:

SetCurveData（CurvePara¶m,CurveData*curvedatap,ub2items,ErrorInfo&error）

表14-10

接口参数

输入/输出

参数（返回值）说明

备注

param

In

曲线参数信息

同GetCurveData接口描述

curvedatap

Out

读取列信息的容器

items

Out

返回表格数据

error

Out

返回表格字符串

返回值

Out

1：

成功；0：

失败

1.1.10.2处理过程及返回值说明

通过解析param结构，获得表格信息，包括表格数据时间间隔、表格号（根据表格号得到数据库表结构、数据集合和取数条件），将曲线修改的数据放入到CurveData结构类型的指针中，包括要求修改的数据、质量位、一一对应的时间等信息，并最终将数据回写回数据库中。

1.1.10.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

if（retcode!

=0）

{

Printf（“theerrorcodeis%dandthedescris%s“,error.error_no,error.error.error_info）;

}

g_CDci.SetSheetData（CurvePara¶m,vector&attr,vector&data,vector&colname,constchar*where_str,constchar*order_by,ErrorInfo&error）;

recode=g_CDci.DisConnect（‘His’,’hisdb’,’hisdb’,error）;

1.1.11从画面表格中修改数据

1.1.11.1参数描述

intCDci:

:

SetSheetData（char*model_name,vector&rec,ErrorInfo&error）

表14-11

接口参数

输入/输出

参数（返回值）说明

备注

model_name

In

和数据结构相关的表格配置号，字符串类型。

rec

Out

回写记录数据

error

Out

出错信息

返回值

Out

1：

成功；0：

失败

1.1.11.2处理过程及返回值说明

通过解析model_name字符串名字，获得表格信息，包括表格数据时间间隔、表格号（根据表格号得到数据库表结构、数据集合和取数条件），将表格修改的数据放入到SheetRecData结构类型的容器中，并最终将数据回写回数据库中。

1.1.11.3调用方法

classCDcig_CDci;

intretcode；

Error_infoerror1;

recode=g_CDci.Connect（‘His’,’hisdb’,’hisdb’,error）;

if（retcode!

=0）

{

Printf（“theerrorcodeis%dandthedescris%s“,error.error_no,error.error.error_info）;

}

g_CDci.SetSheetData（CurvePara¶m,vector&attr,vector&data,vector&colname,constchar*where_str,constchar*order_by,ErrorInfo&error）;

recode=g_CDci.DisConnect（‘His’,’hisdb’,’hisdb’,error）;

1.2商用数据库服务接口HisServiceClientInterface类

1.2.1初始化客户端通信管道

1.2.1.1参数描述

intHisServiceClientInterface:

:

InitSocket（ServiceInfo&service）

表14-12

接口参数

输入/输出

参数（返回值）说明

备注

service

In/Out

ServiceInfo结构，包括服务ip、端口号、底层服务分配句柄handle等信息。

返回值

Out

1：

成功；0：

失败

1.2.1.2处理过程及返回值说明

如果调用HisServiceClientInterface类需要向服务总线注册通信管道和端口信息。

1.2.1.3调用方法

HisServiceClientInterfacehsci1;

ServiceInfoserviceinfo;

serviceinfo.port=20009;

hsci1.InitSocket（ServiceInfo&serviceinfo）;

1.2.2从服务中得到数据

1.2.2.1参数描述

IntHisServiceClientInterface:

:

GetHisFromBaseUsingSingleSql（constchar*cmd_buff,\

time_ttimeout,H