使用CLI开发DB2存储过程的实例

存储过程是使用大型关系型数据库DB2进行开发时，考虑最多的关键问题之一。本文对使用CLI来开发DB2存储过程进行了详述，并附开发实例，供您参考。#t#

■DB2存储过程

存储过程（Store Procedure）是Client/Server应用中的一种编程方式，主要是为了解决客户端应用访问数据库时可能出现的网络负担过重的问题。

　　一般意义上，DB2为存储过程的编写提供了三种方式（不包括直接使用DB2的Store Procedure Builder生成的方式）：第一种是嵌入式SQL编程；第二种是CLI编程；第三种是纯SQL编程。本文将重点介绍CLI编程。

■CLI编程

CLI（Call Level Interface）编程是DB2提供的一种编写动态数据库读写程序的方式。在CLI编程中，所有SQL语句都通过DB2提供的一组C语言函数来执行，因此可以在Visual Studio中直接开发。下面，我们首先要简单介绍一下CLI的工作过程和方式。

CLI程序主要由三个部分组成：首先是环境变量初始化过程，其次是语句的执行，最后是环境变量的释放。我们将通过一个具体的例子来讨论这三个过程。

■开发实例

该例子的数据库是DB2可以自动生成的Sample库，例子所完成的操作是从数据库中获取ID等于输入参数值的员工姓名，例子的整个过程虽然非常简单，但已经包含了CLI编程的基本思路和步骤。

1. 初始化环境变量

在CLI中有三个句柄，分别是环境句柄、连接句柄、语句句柄。在初始化过程中首先要对前两个句柄逐一进行获取，获取成功后可连接数据库并获取第三个句柄。

SQLRETURN ret;

SQLHENV henv; // 环境句柄

SQLHDBC hdbc; // 连接句柄

SQLHSTMT hstmt; // 语句句柄

SQLCHAR DBNAME[]=”SAMPLE”; //数据库名#p#

SQLCHAR USERNAME[]=”db2admin”; // 用户名

SQLCHAR PSW[]=”ibmdb2″; // 口令

ret=SQLAllocEnv(&&henv) //分配环境句柄

ret=SQLAllocConnect(henv,&&hdbc)

//分配连接句柄

ret=SQLSetConnectOption(hdbc,SQL_AUTOCOMMIT,SQL_AUTOCOMMIT_OFF)

//设置连接属性

ret=SQLConnect(hdbc,DBNAME,SQL_NTS,USERNAME,SQL_NTS,PSW,SQL_NTS) //连接数据库

ret=SQLAllocStmt(hdbc,&&hstmt)

//分配语句句柄

上面的每个函数都有返回值,如果函数成功，ret值为SQL_SUCCESS，否则将返回错误代码。

2. 语句的执行

语句的执行分四个阶段：首先准备数据接收的缓冲区，然后执行准备好的SQL语句，第三步是将语句句柄和数据缓冲区进行绑定，最后获取数据。程序如下：

char RowBuffer[100][200];

//数据缓冲区，其大小可自定义

typedef struct sqldat

{ SQLCHAR ColumnName[50];#p#

SQLSMALLINT BufferLength;

SQLSMALLINT NameLength;

SQLSMALLINT DataType;

SQLUINTEGER ColumnSize;

SQLSMALLINT FAR DecimalDigitsPtr;

SQLSMALLINT FAR NullablePtr;

} sqldata;

// 为第三步的绑定准备一个数据结构

sqldata RowDesc[100];

//用于绑定的变量，维数与缓冲区对应

memset(RowBuffer,64,100200);

//给缓冲区赋初始值，可以用于最后判断是否真正从数据库中获取了数据，这一步也可以省略

char tempsql[100];

sprintf(tempsql,”select NAME from db2admin.STAFF where ID= %s “,Condition);

// Condition为变量值，可由用户输入

sql=(SQLCHAR ) tempsql;

ret=SQLPrepare(hstmt,sql,SQL_NTS)

// 执行准备#p#

ret=SQLExecute(hstmt) // 执行

执行成功后可进行绑定过程

SQLINTEGER nullindicator;

SQLINTEGER displaysize[MAX_COLUMN];

SQLSMALLINT i;

SQLSMALLINT num_columns;

SQLNumResultCols(hstmt,&&num_columns);

//准备绑定用的相关变量

for(i=1;i< =num_columns;i++)

{

RowDesc[i-1].BufferLength=200;#p#

SQLDescribeCol(hstmt,i, RowDesc[i-1].ColumnName,RowDesc[i-1].BufferLength,&&(RowDesc[i-1].NameLength),&&(RowDesc[i-1].DataType),&&(RowDesc[i-1].ColumnSize),RowDesc[i-1].DecimalDigitsPtr,RowDesc[i-1].NullablePtr);

SQLColAttribute(hstmt,(SQLSMALLINT)(i),SQL_DESC_DISPLAY_SIZE,NULL,0,NULL,&&displaysize[i-1]);

RowDesc[i-1].ColumnSize=max(displaysize[i-1],strlen((char)RowDesc[i-1].ColumnName))+1;

SQLBindCol( hstmt, (SQLSMALLINT)i,

SQL_C_CHAR,(SQLPOINTER)(RowBuffer[i-1]),RowDesc[i-1].ColumnSize,

&&nullindicator);

｝//循环绑定

//绑定完成后，可以将数据读至缓冲区

while(SQLFetch(hstmt)!=SQL_NO_DATA)

{

// SQLFetch函数将已经获取的数据存入缓冲区

//此处的操作方式与ESQL中的游标类似，支持对结果集的操作

//每执行一次SQLFetch函数会把当前获取的一行数据读到缓冲区中

//RowBuffer[i]中将存放该行的第i 列数据值

//本例中只有一行数据

}

char m_name[10]；

memcpy(m_name,RowBuffer[0],10);

//从缓冲区中将结果读到用户变量中#p#

3. 释放环境变量

在数据获取完成后，可以将环境变量释放掉，但要注意释放的先后顺序。

SQLFreeStmt(hstmt,SQL_DROP);

// 释放语句句柄

SQLDisconnect(hdbc);//与数据库断开

SQLFreeConnect(hdbc);//释放连接句柄

SQLFreeEnv(henv);//释放环境句柄

经过上面的步骤，就完成了对数据库的读取过程。

4. 生成目标存储过程

从上面的过程看，CLI编程无疑是非常复杂的，但如果我们使用一些辅助手段来组织整个过程，其编程过程和调试步骤将会大大简化。本文的例子使用了微软的Visual Studio 6.0来帮助组织。在Visual C++中用Wizard生成一个DLL工程，然后将数据库的初始化、绑定、释放三个过程函数化，并在相应的地方调用函数。在调试时只需针对语句的执行部分，合适的调试方式是不直接生成DLL，而先生成一个普通的EXE工程来完成所需的工作，待调试成功后将相关代码移到DLL工程中。过程函数化的另一个好处是在编写多个存储过程时代码重用率高，对于刚才提到的这种调试方式也很有利。使用Visual C++的优点还有编译和链接过程简单，不用在命令行的方式下操作，也不需要去记忆许多复杂的参数。不过要记住将db2cli.lib包含进工程中，否则在链结过程中会有错误，还要做的一件事是按DLL工程中的要求编辑工程中的def文件以提供函数的可调用出口。

在DLL生成并调试通过后，剩下的工作与ESQL编程方式中的相应阶段类似，要手工编辑一个DB2文件并执行它，这里就不再复述了。