使用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文件并執行它，這里就不再復述了。
