SQLITE3 使用總結(jié)

                   董淳光 42530 (老工號)

 dcg1981@163.com

                     2007年6月11日星期一

（2）              SQL語句操作
本節(jié)介紹如何用sqlite 執(zhí)行標準 sql 語法。

 

i.1            執(zhí)行sql語句

int sqlite3_exec(sqlite3*, const char *sql, sqlite3_callback, void *,  char **errmsg );

這就是執(zhí)行一條 sql 語句的函數(shù)。

第1個參數(shù)不再說了，是前面open函數(shù)得到的指針。說了是關(guān)鍵數(shù)據(jù)結(jié)構(gòu)。

第2個參數(shù)const char *sql 是一條 sql 語句，以\0結(jié)尾。

第3個參數(shù)sqlite3_callback 是回調(diào)，當這條語句執(zhí)行之后，sqlite3會去調(diào)用你提供的這個函數(shù)。（什么是回調(diào)函數(shù)，自己找別的資料學(xué)習(xí)）

第4個參數(shù)void * 是你所提供的指針，你可以傳遞任何一個指針參數(shù)到這里，這個參數(shù)最終會傳到回調(diào)函數(shù)里面，如果不需要傳遞指針給回調(diào)函數(shù)，可以填NULL。等下我們再看回調(diào)函數(shù)的寫法，以及這個參數(shù)的使用。

第5個參數(shù)char ** errmsg 是錯誤信息。注意是指針的指針。sqlite3里面有很多固定的錯誤信息。執(zhí)行 sqlite3_exec 之后，執(zhí)行失敗時可以查閱這個指針（直接 printf(“%s\n”,errmsg)）得到一串字符串信息，這串信息告訴你錯在什么地方。sqlite3_exec函數(shù)通過修改你傳入的指針的指針，把你提供的指針指向錯誤提示信息，這樣sqlite3_exec函數(shù)外面就可以通過這個 char*得到具體錯誤提示。

說明：通常，sqlite3_callback 和它后面的 void * 這兩個位置都可以填 NULL。填NULL表示你不需要回調(diào)。比如你做 insert 操作，做 delete 操作，就沒有必要使用回調(diào)。而當你做 select 時，就要使用回調(diào)，因為 sqlite3 把數(shù)據(jù)查出來，得通過回調(diào)告訴你查出了什么數(shù)據(jù)。

 

i.2            exec 的回調(diào)

typedef int (*sqlite3_callback)(void*,int,char**, char**);

你的回調(diào)函數(shù)必須定義成上面這個函數(shù)的類型。下面給個簡單的例子：

//sqlite3的回調(diào)函數(shù)         

// sqlite 每查到一條記錄，就調(diào)用一次這個回調(diào)

     int LoadMyInfo( void * para, int n_column, char ** column_value, char ** column_name )

{

          //para是你在 sqlite3_exec 里傳入的 void * 參數(shù)

          //通過para參數(shù)，你可以傳入一些特殊的指針（比如類指針、結(jié)構(gòu)指針），然后在這里面強制轉(zhuǎn)換成對應(yīng)的類型（這里面是void*類型，必須強制轉(zhuǎn)換成你的類型才可用）。然后操作這些數(shù)據(jù)

          //n_column是這一條記錄有多少個字段 (即這條記錄有多少列)

          // char ** column_value 是個關(guān)鍵值，查出來的數(shù)據(jù)都保存在這里，它實際上是個1維數(shù)組（不要以為是2維數(shù)組），每一個元素都是一個 char * 值，是一個字段內(nèi)容（用字符串來表示，以\0結(jié)尾）

          //char ** column_name 跟 column_value是對應(yīng)的，表示這個字段的字段名稱

          

          //這里，我不使用 para 參數(shù)。忽略它的存在.

 

          int i;

printf( “記錄包含 %d 個字段\n”, n_column );

for( i = 0 ; i < n_column; i ++ )

{

     printf( “字段名:%s  ?> 字段值:%s\n”,  column_name[i], column_value[i] );

}

printf( “------------------\n“ );         

return 0;

}

 

int main( int , char ** )

{

          sqlite3 * db;

          int result;

          char * errmsg = NULL;

 

          result = sqlite3_open( “c:\\Dcg_database.db”, &db );

    if( result != SQLITE_OK )

    {

     //數(shù)據(jù)庫打開失敗

return -1;

}

//數(shù)據(jù)庫操作代碼

//創(chuàng)建一個測試表，表名叫 MyTable_1，有2個字段： ID 和 name。其中ID是一個自動增加的類型，以后insert時可以不去指定這個字段，它會自己從0開始增加

result = sqlite3_exec( db, “create table MyTable_1( ID integer primary key autoincrement, name nvarchar(32) )”, NULL, NULL, errmsg );

if(result != SQLITE_OK )

{

     printf( “創(chuàng)建表失敗，錯誤碼:%d，錯誤原因:%s\n”, result, errmsg );

}

//插入一些記錄

result = sqlite3_exec( db, “insert into MyTable_1( name ) values ( ‘走路’ )”, 0, 0, errmsg );

if(result != SQLITE_OK )

{

     printf( “插入記錄失敗，錯誤碼:%d，錯誤原因:%s\n”, result, errmsg );

}

result = sqlite3_exec( db, “insert into MyTable_1( name ) values ( ‘騎單車’ )”, 0, 0, errmsg );

if(result != SQLITE_OK )

{

     printf( “插入記錄失敗，錯誤碼:%d，錯誤原因:%s\n”, result, errmsg );

}

result = sqlite3_exec( db, “insert into MyTable_1( name ) values ( ‘坐汽車’ )”, 0, 0, errmsg );

if(result != SQLITE_OK )

{

     printf( “插入記錄失敗，錯誤碼:%d，錯誤原因:%s\n”, result, errmsg );

}

 

 

//開始查詢數(shù)據(jù)庫

result = sqlite3_exec( db, “select * from MyTable_1”, LoadMyInfo, NULL, errmsg );

 

//關(guān)閉數(shù)據(jù)庫

sqlite3_close( db );

return 0;

}

 

通過上面的例子，應(yīng)該可以知道如何打開一個數(shù)據(jù)庫，如何做數(shù)據(jù)庫基本操作。

有這些知識，基本上可以應(yīng)付很多數(shù)據(jù)庫操作了。

 

i.3            不使用回調(diào)查詢數(shù)據(jù)庫

上面介紹的 sqlite3_exec 是使用回調(diào)來執(zhí)行 select 操作。還有一個方法可以直接查詢而不需要回調(diào)。但是，我個人感覺還是回調(diào)好，因為代碼可以更加整齊，只不過用回調(diào)很麻煩，你得聲明一個函數(shù)，如果這個函數(shù)是類成員函數(shù)，你還不得不把它聲明成 static 的（要問為什么？這又是C++基礎(chǔ)了。C++成員函數(shù)實際上隱藏了一個參數(shù)：this，C++調(diào)用類的成員函數(shù)的時候，隱含把類指針當成函數(shù)的第一個參數(shù)傳遞進去。結(jié)果，這造成跟前面說的 sqlite 回調(diào)函數(shù)的參數(shù)不相符。只有當把成員函數(shù)聲明成 static 時，它才沒有多余的隱含的this參數(shù)）。

雖然回調(diào)顯得代碼整齊，但有時候你還是想要非回調(diào)的 select 查詢。這可以通過 sqlite3_get_table 函數(shù)做到。

int sqlite3_get_table(sqlite3*, const char *sql, char ***resultp, int *nrow, int *ncolumn, char **errmsg );

第1個參數(shù)不再多說，看前面的例子。

第2個參數(shù)是 sql 語句，跟 sqlite3_exec 里的 sql 是一樣的。是一個很普通的以\0結(jié)尾的char *字符串。

第3個參數(shù)是查詢結(jié)果，它依然一維數(shù)組（不要以為是二維數(shù)組，更不要以為是三維數(shù)組）。它內(nèi)存布局是：第一行是字段名稱，后面是緊接著是每個字段的值。下面用例子來說事。

第4個參數(shù)是查詢出多少條記錄（即查出多少行）。

第5個參數(shù)是多少個字段（多少列）。

第6個參數(shù)是錯誤信息，跟前面一樣，這里不多說了。

下面給個簡單例子:

int main( int , char ** )

{

          sqlite3 * db;

          int result;

          char * errmsg = NULL;

char **dbResult; //是 char ** 類型，兩個*號

          int nRow, nColumn;

          int i , j;

          int index;

 

          result = sqlite3_open( “c:\\Dcg_database.db”, &db );

    if( result != SQLITE_OK )

    {

     //數(shù)據(jù)庫打開失敗

return -1;

}

//數(shù)據(jù)庫操作代碼

//假設(shè)前面已經(jīng)創(chuàng)建了 MyTable_1 表

//開始查詢，傳入的 dbResult 已經(jīng)是 char **，這里又加了一個 & 取地址符，傳遞進去的就成了 char ***

result = sqlite3_get_table( db, “select * from MyTable_1”, &dbResult, &nRow, &nColumn, &errmsg );

if( SQLITE_OK == result )

{

     //查詢成功

 

    index = nColumn; //前面說過 dbResult 前面第一行數(shù)據(jù)是字段名稱，從 nColumn 索引開始才是真正的數(shù)據(jù)

     printf( “查到%d條記錄\n”, nRow );

     for(  i = 0; i < nRow ; i++ )

     {

         printf( “第 %d 條記錄\n”, i+1 ); 

         for( j = 0 ; j < nColumn; j++ )

         {

              printf( “字段名:%s  ?> 字段值:%s\n”,  dbResult[j], dbResult [index] );

              ++index; // dbResult 的字段值是連續(xù)的，從第0索引到第 nColumn - 1索引都是字段名稱，從第 nColumn 索引開始，后面都是字段值，它把一個二維的表（傳統(tǒng)的行列表示法）用一個扁平的形式來表示

         }

         printf( “-------\n” );

     }

}

 

//到這里，不論數(shù)據(jù)庫查詢是否成功，都釋放 char** 查詢結(jié)果，使用 sqlite 提供的功能來釋放

sqlite3_free_table( dbResult );

 

//關(guān)閉數(shù)據(jù)庫

sqlite3_close( db );

return 0;

}

 

到這個例子為止，sqlite3 的常用用法都介紹完了。

用以上的方法，再配上 sql 語句，完全可以應(yīng)付絕大多數(shù)數(shù)據(jù)庫需求。

但有一種情況，用上面方法是無法實現(xiàn)的：需要insert、select 二進制。當需要處理二進制數(shù)據(jù)時，上面的方法就沒辦法做到。下面這一節(jié)說明如何插入二進制數(shù)據(jù)

（2）              操作二進制
sqlite 操作二進制數(shù)據(jù)需要用一個輔助的數(shù)據(jù)類型：sqlite3_stmt * 。

這個數(shù)據(jù)類型記錄了一個“sql語句”。為什么我把 “sql語句” 用雙引號引起來？因為你可以把 sqlite3_stmt * 所表示的內(nèi)容看成是 sql語句，但是實際上它不是我們所熟知的sql語句。它是一個已經(jīng)把sql語句解析了的、用sqlite自己標記記錄的內(nèi)部數(shù)據(jù)結(jié)構(gòu)。

正因為這個結(jié)構(gòu)已經(jīng)被解析了，所以你可以往這個語句里插入二進制數(shù)據(jù)。當然，把二進制數(shù)據(jù)插到 sqlite3_stmt 結(jié)構(gòu)里可不能直接 memcpy ，也不能像 std::string 那樣用 + 號。必須用 sqlite 提供的函數(shù)來插入。

 

i.1          寫入二進制

下面說寫二進制的步驟。

要插入二進制，前提是這個表的字段的類型是 blob 類型。我假設(shè)有這么一張表：

create table Tbl_2( ID integer, file_content  blob )

首先聲明 

sqlite3_stmt * stat;

然后，把一個 sql 語句解析到 stat 結(jié)構(gòu)里去：

sqlite3_prepare( db, “insert into Tbl_2( ID, file_content) values( 10, ? )”, -1, &stat, 0 );

上面的函數(shù)完成 sql 語句的解析。第一個參數(shù)跟前面一樣，是個 sqlite3 * 類型變量，第二個參數(shù)是一個 sql 語句。

這個 sql 語句特別之處在于 values 里面有個 ? 號。在sqlite3_prepare函數(shù)里，?號表示一個未定的值，它的值等下才插入。

第三個參數(shù)我寫的是-1，這個參數(shù)含義是前面 sql 語句的長度。如果小于0，sqlite會自動計算它的長度（把sql語句當成以\0結(jié)尾的字符串）。

第四個參數(shù)是 sqlite3_stmt 的指針的指針。解析以后的sql語句就放在這個結(jié)構(gòu)里。

第五個參數(shù)我也不知道是干什么的。為0就可以了。

如果這個函數(shù)執(zhí)行成功（返回值是 SQLITE_OK 且 stat 不為NULL ），那么下面就可以開始插入二進制數(shù)據(jù)。

sqlite3_bind_blob( stat, 1, pdata, (int)(length_of_data_in_bytes), NULL ); // pdata為數(shù)據(jù)緩沖區(qū)，length_of_data_in_bytes為數(shù)據(jù)大小，以字節(jié)為單位

這個函數(shù)一共有5個參數(shù)。

第1個參數(shù)：是前面prepare得到的 sqlite3_stmt * 類型變量。

第2個參數(shù)：?號的索引。前面prepare的sql語句里有一個?號，假如有多個?號怎么插入？方法就是改變 bind_blob 函數(shù)第2個參數(shù)。這個參數(shù)我寫1，表示這里插入的值要替換 stat 的第一個?號（這里的索引從1開始計數(shù)，而非從0開始）。如果你有多個?號，就寫多個 bind_blob 語句，并改變它們的第2個參數(shù)就替換到不同的?號。如果有?號沒有替換，sqlite為它取值null。

第3個參數(shù)：二進制數(shù)據(jù)起始指針。

第4個參數(shù)：二進制數(shù)據(jù)的長度，以字節(jié)為單位。

第5個參數(shù)：是個析夠回調(diào)函數(shù)，告訴sqlite當把數(shù)據(jù)處理完后調(diào)用此函數(shù)來析夠你的數(shù)據(jù)。這個參數(shù)我還沒有使用過，因此理解也不深刻。但是一般都填NULL，需要釋放的內(nèi)存自己用代碼來釋放。

bind完了之后，二進制數(shù)據(jù)就進入了你的“sql語句”里了。你現(xiàn)在可以把它保存到數(shù)據(jù)庫里：

int result = sqlite3_step( stat );

通過這個語句，stat 表示的sql語句就被寫到了數(shù)據(jù)庫里。

最后，要把 sqlite3_stmt 結(jié)構(gòu)給釋放：

sqlite3_finalize( stat ); //把剛才分配的內(nèi)容析構(gòu)掉

 

i.2          讀出二進制

下面說讀二進制的步驟。

跟前面一樣，先聲明 sqlite3_stmt * 類型變量：

sqlite3_stmt * stat;

然后，把一個 sql 語句解析到 stat 結(jié)構(gòu)里去：

sqlite3_prepare( db, “select * from Tbl_2”, -1, &stat, 0 );

當 prepare 成功之后（返回值是 SQLITE_OK ），開始查詢數(shù)據(jù)。

int result = sqlite3_step( stat );

這一句的返回值是 SQLITE_ROW 時表示成功（不是 SQLITE_OK ）。

你可以循環(huán)執(zhí)行 sqlite3_step 函數(shù)，一次 step 查詢出一條記錄。直到返回值不為 SQLITE_ROW 時表示查詢結(jié)束。

然后開始獲取第一個字段：ID 的值。ID是個整數(shù)，用下面這個語句獲取它的值：

int id = sqlite3_column_int( stat, 0 ); //第2個參數(shù)表示獲取第幾個字段內(nèi)容，從0開始計算，因為我的表的ID字段是第一個字段，因此這里我填0

 

下面開始獲取 file_content 的值，因為 file_content 是二進制，因此我需要得到它的指針，還有它的長度：

         const void * pFileContent = sqlite3_column_blob( stat, 1 );

         int len = sqlite3_column_bytes( stat, 1 );

這樣就得到了二進制的值。

把 pFileContent 的內(nèi)容保存出來之后，不要忘了釋放 sqlite3_stmt 結(jié)構(gòu)：

sqlite3_finalize( stat ); //把剛才分配的內(nèi)容析構(gòu)掉

 

i.3          重復(fù)使用 sqlite3_stmt 結(jié)構(gòu)

如果你需要重復(fù)使用 sqlite3_prepare 解析好的 sqlite3_stmt 結(jié)構(gòu)，需要用函數(shù)： sqlite3_reset。

result = sqlite3_reset(stat);

這樣， stat 結(jié)構(gòu)又成為 sqlite3_prepare 完成時的狀態(tài)，你可以重新為它 bind 內(nèi)容。