Linux下基於C 的DB2CLI開發

 

Linux下基於C 的DB2CLI開發

http://blog.sina.com.cn/s/blog_76739a0c0100qhy7.html

您查看的文章來源於http://www.oklinux.cn

db2數據庫提供了一套自己的應用程序編程接口(API)---db2 call level interface,簡稱爲db2cli編程接口,目前支持C和C 。

db2cli基於MicrosoftOpenDatabaseConnectivity(ODBC)規範實現。

以C 爲例進行db2cli編程,對db2數據庫進行操作。

源代碼首先需要include入“sqlcli1.h”,這是最新版本的db2cli提供的頭文件,該頭文件中會自動引用db2cli的其他相關頭文件。

引入了“sqlcli1.h”後,代碼中就可以使用db2cli進行編程了,下文會詳細介紹使用db2cli編程操作db2數據庫的大致步驟,先講下源代碼的編譯。

假設源代碼文件爲db2test.cpp,編譯命令爲

  g -L/home/db2inst1/sqllib/lib32 -I/home/db2inst1/sqllib/include/ -ldb2

db2test.cpp

-L是庫搜索路徑,編譯中需要用到的libdb2.so就在存放在該路徑下;-I是頭文件搜索路徑,sqlcli1.h和其他引用的頭文件都在該路徑下;-ldb2是指定編譯時用到的庫文件libdb2.so,格式爲-l$庫文件名稱後半部分。

這樣的話就會生成默認的目標文件a.out。

代碼中使用db2cli操作db2數據庫的大致步驟如下,首先使用SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&henv)獲取一個數據庫的環境句柄。SQL_HANDLE_ENV是入參,標識需要獲取一個什麼類型的數據庫句柄;SQL_NULL_HANDLE是入參,是需要輸入的前提句柄;&henv是出參,獲取到的句柄地址會存放在&henv。

可能需要使用SQLSetEnvAttr()來設置環境句柄的一些參數。

然後再使用SQLAllocHandle(SQL_HANDLE_DBC,henv,&hdbc)來分配一個數據庫的連接句柄。

可能需要使用SQLSetConnectAttr()來設置連接句柄的一些參數。

然後使用SQLConnect(hdbc,db,SQL_NTS,user,SQL_NTS,pwd,SQL_NTS)來連接名稱爲db的數據庫。

到這數據庫連接就初始化完成了,下面可以使用語句句柄執行具體的db2命令了。

以查詢語句

select version from NE12.TBL_0_20080906

爲例,介紹使用db2cli執行具體的db2命令的大致步驟。

首先使用SQLAllocHandle(SQL_HANDLE_STMT,hdbc,&hstmt)來獲取一個語句句柄hstmt。

然後使用SQLPrepare(hstmt,$SQL,$SQL.length)來將SQL語句和語句句柄綁定,$SQL.length是SQL語句的長度。

然後就可以執行該SQL語句了,SQL語句的執行分爲幾種情況,有SQL中包含參數和不包含參數的,有查詢類SQL語句和非查詢類SQL語句,不一一介紹,詳細可以參考db2信息中心。SQL語句通過調用SQLExcute(hstmt)或SQLExeDirect(hstmt,$SQL,$SQL.length)執行。兩個函數的主要區別在於SQLExcute()可以多次被調用以達到多次執行綁定到該語句句柄上SQL語句的目的,而SQLExeDirecte()多用於只執行一次的SQL語句。

如果有返回結果的話可以在執行SQL語句之前使用SQLBindCol(hstmt,

ColNum,DataType,&DataValue,BufferLen,&StrLen)來實現將db2返回結果的某列值綁定到制定的存儲位置。ColNum是需要綁定的列在返回結果中的列序號,DataType指明該列的數據類型,&DataValue是緩存該列的一行數據的臨時存儲空間,BufferLen是緩存空間的大小,&StrLen是存放返回結果大小的地址。

上面之所以需要綁定一個臨時存儲空間,是因爲取返回結果時需要按列一行一行的順序獲取,執行完SQL語句後,緊接着執行SQLFetch(),db2就會將返回結果的各列的一行數據按事先綁定的規則放置到指定的緩存空間去,從緩存空間中獲取完這一行數據後,緊接着再執行SQLFetch()就可以獲取下一行數據,依此類推,直至執行SQLFetch()返回失敗,則表示結果已取完。

完成了對數據庫的相關操作之後需要將之前申請的數據庫連接進行釋放,釋放的大致步驟如下,使用SQLFreeHandle(SQL_HANDLE_STMT,hstmt)釋放語句句柄;

使用SQLDisconnect(hdbc)斷開數據庫連接句柄和相應數據庫的連接;

使用SQLFreeHandle(SQL_HANDLE_DBC,hdbc)釋放連接句柄;

使用SQLFreeHandle(SQLP_HANDLE_ENV,henv)釋放環境句柄。

至此數據庫連接的清理工作完成。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章