使用CLI開發(fā)DB2存儲(chǔ)過程的實(shí)例
存儲(chǔ)過程是使用大型關(guān)系型數(shù)據(jù)庫DB2進(jìn)行開發(fā)時(shí),考慮最多的關(guān)鍵問題之一。本文對(duì)使用CLI來開發(fā)DB2存儲(chǔ)過程進(jìn)行了詳述,并附開發(fā)實(shí)例,供您參考。#t#
■DB2存儲(chǔ)過程
存儲(chǔ)過程(Store Procedure)是Client/Server應(yīng)用中的一種編程方式,主要是為了解決客戶端應(yīng)用訪問數(shù)據(jù)庫時(shí)可能出現(xiàn)的網(wǎng)絡(luò)負(fù)擔(dān)過重的問題。
一般意義上,DB2為存儲(chǔ)過程的編寫提供了三種方式(不包括直接使用DB2的Store Procedure Builder生成的方式):第一種是嵌入式SQL編程;第二種是CLI編程;第三種是純SQL編程。本文將重點(diǎn)介紹CLI編程。
■CLI編程
CLI(Call Level Interface)編程是DB2提供的一種編寫動(dòng)態(tài)數(shù)據(jù)庫讀寫程序的方式。在CLI編程中,所有SQL語句都通過DB2提供的一組C語言函數(shù)來執(zhí)行,因此可以在Visual Studio中直接開發(fā)。下面,我們首先要簡(jiǎn)單介紹一下CLI的工作過程和方式。
CLI程序主要由三個(gè)部分組成:首先是環(huán)境變量初始化過程,其次是語句的執(zhí)行,最后是環(huán)境變量的釋放。我們將通過一個(gè)具體的例子來討論這三個(gè)過程。
■開發(fā)實(shí)例
該例子的數(shù)據(jù)庫是DB2可以自動(dòng)生成的Sample庫,例子所完成的操作是從數(shù)據(jù)庫中獲取ID等于輸入?yún)?shù)值的員工姓名,例子的整個(gè)過程雖然非常簡(jiǎn)單,但已經(jīng)包含了CLI編程的基本思路和步驟。
1. 初始化環(huán)境變量
在CLI中有三個(gè)句柄,分別是環(huán)境句柄、連接句柄、語句句柄。在初始化過程中首先要對(duì)前兩個(gè)句柄逐一進(jìn)行獲取,獲取成功后可連接數(shù)據(jù)庫并獲取第三個(gè)句柄。
SQLRETURN ret;
SQLHENV henv; // 環(huán)境句柄
SQLHDBC hdbc; // 連接句柄
SQLHSTMT hstmt; // 語句句柄
SQLCHAR DBNAME[]="SAMPLE"; //數(shù)據(jù)庫名#p#
SQLCHAR USERNAME[]="db2admin"; // 用戶名
SQLCHAR PSW[]="ibmdb2"; // 口令
ret=SQLAllocEnv(&&henv) //分配環(huán)境句柄
ret=SQLAllocConnect(henv,&&hdbc)
//分配連接句柄
ret=SQLSetConnectOption(hdbc,SQL_AUTOCOMMIT,SQL_AUTOCOMMIT_OFF)
//設(shè)置連接屬性
ret=SQLConnect(hdbc,DBNAME,SQL_NTS,USERNAME,SQL_NTS,PSW,SQL_NTS) //連接數(shù)據(jù)庫
ret=SQLAllocStmt(hdbc,&&hstmt)
//分配語句句柄
上面的每個(gè)函數(shù)都有返回值,如果函數(shù)成功,ret值為SQL_SUCCESS,否則將返回錯(cuò)誤代碼。
2. 語句的執(zhí)行
語句的執(zhí)行分四個(gè)階段:首先準(zhǔn)備數(shù)據(jù)接收的緩沖區(qū),然后執(zhí)行準(zhǔn)備好的SQL語句,第三步是將語句句柄和數(shù)據(jù)緩沖區(qū)進(jìn)行綁定,最后獲取數(shù)據(jù)。程序如下:
char RowBuffer[100][200];
//數(shù)據(jù)緩沖區(qū),其大小可自定義
typedef struct sqldat
{ SQLCHAR ColumnName[50];#p#
SQLSMALLINT BufferLength;
SQLSMALLINT NameLength;
SQLSMALLINT DataType;
SQLUINTEGER ColumnSize;
SQLSMALLINT FAR DecimalDigitsPtr;
SQLSMALLINT FAR NullablePtr;
} sqldata;
// 為第三步的綁定準(zhǔn)備一個(gè)數(shù)據(jù)結(jié)構(gòu)
sqldata RowDesc[100];
//用于綁定的變量,維數(shù)與緩沖區(qū)對(duì)應(yīng)
memset(RowBuffer,64,100200);
//給緩沖區(qū)賦初始值,可以用于最后判斷是否真正從數(shù)據(jù)庫中獲取了數(shù)據(jù),這一步也可以省略
char tempsql[100];
sprintf(tempsql,"select NAME from db2admin.STAFF where ID= %s ",Condition);
// Condition為變量值,可由用戶輸入
sql=(SQLCHAR ) tempsql;
ret=SQLPrepare(hstmt,sql,SQL_NTS)
// 執(zhí)行準(zhǔn)備#p#
ret=SQLExecute(hstmt) // 執(zhí)行
執(zhí)行成功后可進(jìn)行綁定過程
SQLINTEGER nullindicator;
SQLINTEGER displaysize[MAX_COLUMN];
SQLSMALLINT i;
SQLSMALLINT num_columns;
SQLNumResultCols(hstmt,&&num_columns);
//準(zhǔn)備綁定用的相關(guān)變量
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);
}//循環(huán)綁定
//綁定完成后,可以將數(shù)據(jù)讀至緩沖區(qū)
while(SQLFetch(hstmt)!=SQL_NO_DATA)
{
// SQLFetch函數(shù)將已經(jīng)獲取的數(shù)據(jù)存入緩沖區(qū)
//此處的操作方式與ESQL中的游標(biāo)類似,支持對(duì)結(jié)果集的操作
//每執(zhí)行一次SQLFetch函數(shù)會(huì)把當(dāng)前獲取的一行數(shù)據(jù)讀到緩沖區(qū)中
//RowBuffer[i]中將存放該行的第i 列數(shù)據(jù)值
//本例中只有一行數(shù)據(jù)
}
char m_name[10];
memcpy(m_name,RowBuffer[0],10);
//從緩沖區(qū)中將結(jié)果讀到用戶變量中#p#
3. 釋放環(huán)境變量
在數(shù)據(jù)獲取完成后,可以將環(huán)境變量釋放掉,但要注意釋放的先后順序。
SQLFreeStmt(hstmt,SQL_DROP);
// 釋放語句句柄
SQLDisconnect(hdbc);//與數(shù)據(jù)庫斷開
SQLFreeConnect(hdbc);//釋放連接句柄
SQLFreeEnv(henv);//釋放環(huán)境句柄
經(jīng)過上面的步驟,就完成了對(duì)數(shù)據(jù)庫的讀取過程。
4. 生成目標(biāo)存儲(chǔ)過程
從上面的過程看,CLI編程無疑是非常復(fù)雜的,但如果我們使用一些輔助手段來組織整個(gè)過程,其編程過程和調(diào)試步驟將會(huì)大大簡(jiǎn)化。本文的例子使用了微軟的Visual Studio 6.0來幫助組織。在Visual C++中用Wizard生成一個(gè)DLL工程,然后將數(shù)據(jù)庫的初始化、綁定、釋放三個(gè)過程函數(shù)化,并在相應(yīng)的地方調(diào)用函數(shù)。在調(diào)試時(shí)只需針對(duì)語句的執(zhí)行部分,合適的調(diào)試方式是不直接生成DLL,而先生成一個(gè)普通的EXE工程來完成所需的工作,待調(diào)試成功后將相關(guān)代碼移到DLL工程中。過程函數(shù)化的另一個(gè)好處是在編寫多個(gè)存儲(chǔ)過程時(shí)代碼重用率高,對(duì)于剛才提到的這種調(diào)試方式也很有利。使用Visual C++的優(yōu)點(diǎn)還有編譯和鏈接過程簡(jiǎn)單,不用在命令行的方式下操作,也不需要去記憶許多復(fù)雜的參數(shù)。不過要記住將db2cli.lib包含進(jìn)工程中,否則在鏈結(jié)過程中會(huì)有錯(cuò)誤,還要做的一件事是按DLL工程中的要求編輯工程中的def文件以提供函數(shù)的可調(diào)用出口。
在DLL生成并調(diào)試通過后,剩下的工作與ESQL編程方式中的相應(yīng)階段類似,要手工編輯一個(gè)DB2文件并執(zhí)行它,這里就不再復(fù)述了。