轉載於：http://blog.chinaunix.net/uid-22362310-id-128105.html
SQLITE3 使用總結（1～2）
＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊前序：
一、版本
二、基本編譯
三、SQLITE操作入門
（1）基本流程
（2）SQL語句操作
（3）操作二進制
（4）事務處理
四、給數據庫加密
五、後記
＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊＊
! S: ^6 n$ p* l/ w- h( [1 s( ]* W
0 p* T ?8前序：
2 B9 O! N* w0 K6 n" d! c+ ]8 O
Sqlite3 的確很好用。小巧、速度快。但是因爲非微軟的產品，幫助文檔總覺得不夠。這些天再次研究它，又有一些收穫，這裏把我對 sqlite3 的研究列出來，以備忘記。
. K8 I# y8 ~6 f. o% J7 E
這裏要註明，我是一個跨平臺專注者，並不喜歡只用 windows 平臺。我以前的工作就是爲 unix 平臺寫代碼。下面我所寫的東西，雖然沒有驗證，但是我已儘量不使用任何 windows 的東西，只使用標準 C 或標準C++。但是，我沒有嘗試過在別的系統、別的編譯器下編譯，因此下面的敘述如果不正確，則留待以後修改。
% }. }" x4 d* K `$ i9 C/ n* p
下面我的代碼仍然用 VC 編寫，因爲我覺得VC是一個很不錯的IDE，可以加快代碼編寫速度（例如配合 Vassist ）。下面我所說的編譯環境，是VC2003。如果讀者覺得自己習慣於 unix 下用 vi 編寫代碼速度較快，可以不用管我的說明，只需要符合自己習慣即可，因爲我用的是標準 C 或 C++ 。不會給任何人帶來不便。2 j" ~7 r2 }( X1 u+ |! m7 u
2 @. ~' g8 s$ H
一、版本
從 http://www.sqlite.org/ 網站可下載到最新的 sqlite 代碼和編譯版本。我寫此文章時，最新代碼是 3.3.17 版本。 % k$ } v& G( d# M: u0 S
4 A0 H g$ Z: u: `0 ~& k: v* G
很久沒有去下載 sqlite 新代碼，因此也不知道 sqlite 變化這麼大。以前很多文件，現在全部合併成一個 sqlite3.c 文件。如果單獨用此文件，是挺好的，省去拷貝一堆文件還擔心有沒有遺漏。但是也帶來一個問題：此文件太大，快接近7萬行代碼，VC開它整個機器都慢下來 了。如果不需要改它代碼，也就不需要打開 sqlite3.c 文件，機器不會慢。但是，下面我要寫通過修改 sqlite 代碼完成加密功能，那時候就比較痛苦了。如果個人水平較高，建議用些簡單的編輯器來編輯，例如 UltraEdit 或 Notepad 。速度會快很多。 ~8 a7 O: B/ t, `( `
9 i* ^7 J! m; Z4 g5 b) n$ f" Z
二、基本編譯
這個不想多說了，在 VC 裏新建 dos 控制檯空白工程，把 sqlite3.c 和 sqlite3.h 添加到工程，再新建一個 main.cpp 文件。在裏面寫: / ~$ j* e. Q# l* A9 p3 M
7 N' v9 `4 Z9 J5 \2 Z! }
extern "C"
& b! W2 S; i8 {4 _/ H3 I/ s" O
{/ O7 d8 P# N4 _" g' p @6 V
#include "./sqlite3.h" 8 r: p2 h6 n. B) `5 Z2 D
}; 2 f ~, J5 A# X' x
" W" n! f. A F+ _
int main( int , char** )1 g; f( S6 s+ }$ u
/ s# ?' q* T( E' L, F8 o- \
{5 W1 x: U4 [% A2 z, M
}5 z' f: D7 A, m2 \
return 0;7 L0 J9 ^5 B' @/ C6 U: b6 X1 n
}
爲什麼要 extern “C” ？如果問這個問題，我不想說太多，這是C++的基礎。要在 C++ 裏使用一段 C 的代碼，必須要用 extern “C” 括起來。C++跟 C雖然語法上有重疊，但是它們是兩個不同的東西，內存裏的佈局是完全不同的，在C++編譯器裏不用extern “C”括起C代碼，會導致編譯器不知道該如何爲 C 代碼描述內存佈局。 # v, H( q; }7 H" f
( ~5 d0 c# A$ j2 D2 k
可能在 sqlite3.c 里人家已經把整段代碼都 extern “C” 括起來了，但是你遇到一個 .c 文件就自覺的再括一次，也沒什麼不好。0 N+ R+ H: A7 n% @# K% H
M9 ~ b2 Q* X. Y" d
基本工程就這樣建立起來了。編譯，可以通過。但是有一堆的 warning。可以不管它。3 ]1 V; R, H5 k+ D$ @4 a8 Z
$ c3 K4 {6 ?: E' p4
三、SQLITE操作入門
3 m) S. R+ l$ D0 ]
sqlite提供的是一些C函數接口，你可以用這些函數操作數據庫。通過使用這些接口，傳遞一些標準 sql 語句（以 char * 類型）給 sqlite 函數，sqlite 就會爲你操作數據庫。
sqlite 跟MS的access一樣是文件型數據庫，就是說，一個數據庫就是一個文件，此數據庫裏可以建立很多的表，可以建立索引、觸發器等等，但是，它實際上得到的就是一個文件。備份這個文件就備份了整個數據庫。 ' F( n8 ~, c- S
8 U( i4 p8 U$ n5 j) q! ^
sqlite 不需要任何數據庫引擎，這意味着如果你需要 sqlite 來保存一些用戶數據，甚至都不需要安裝數據庫(如果你做個小軟件還要求人家必須裝了sqlserver 才能運行，那也太黑心了)。
4 T5 v4 Z6 v5 U0 U6 J8 n
下面開始介紹數據庫基本操作。
, @1 c; I, Q% @
（1） 基本流程
i.1 關鍵數據結構 1 B2 r( k: U1 P* l0 v
sqlite 裏最常用到的是 sqlite3 * 類型。從數據庫打開開始，sqlite就要爲這個類型準備好內存，直到數據庫關閉，整個過程都需要用到這個類型。當數據庫打開時開始，這個類型的變量就代表了你要操作的數據庫。下面再詳細介紹。
i.2 打開數據庫 ) W) k6 | o( D$ B- U
& ^; U& o* Z; t6 U1 M- M
int sqlite3_open( 文件名, sqlite3 ** );% c& ]* t6 D7 J- g
7 g Q! F5 z- b* w# g/ [% _
用這個函數開始數據庫操作。& R& W5 ^0 }: x, U. k
需要傳入兩個參數，一是數據庫文件名，比如：c:\\DongChunGuang_Database.db。
" J$ ^- G' n. D% T, w
文件名不需要一定存在，如果此文件不存在，sqlite 會自動建立它。如果它存在，就嘗試把它當數據庫文件來打開。1 F W+ `1 v$ K- J3 o" v( i' G
, c0 \# U% y4 X- @$ o, U' `! z
sqlite3 ** 參數即前面提到的關鍵數據結構。這個結構底層細節如何，你不要關它。' w4 ~- E4 g' K: ]7 X2 A
函數 返回值表示操作是否正確，如果是 SQLITE_OK 則表示操作正常。相關的返回值sqlite定義了一些宏。具體這些宏的含義可以參考 sqlite3.h 文件。裏面有詳細定義（順便說一下，sqlite3 的代碼註釋率自稱是非常高的，實際上也的確很高。只要你會看英文，sqlite 可以讓你學到不少東西）。
下面介紹關閉數據庫後，再給一段參考代碼。
i.3 關閉數據庫 " |3 b6 G1 T) @: w( G9 i8 q3 v
int sqlite3_close(sqlite3 *);
3 i2 k1 a1 {, C9 z5 C8 j0 c( }
前面如果用 sqlite3_open 開啓了一個數據庫，結尾時不要忘了用這個函數關閉數據庫。
下面給段簡單的代碼：
( h& {6 A" ]+ r. q% u3 z( G
extern "C"/ a1 e- ^5 n, B
7 r, N' u* _4 a2 m* z9 ]5 T
{
#include "./sqlite3.h" 4 }) B9 V# o% e/ a
}; " V ~. a u C3 o5 b
" u% H7 B- X' w; ~
int main( int , char** )0 m' ^. q# l3 f+ s) y7 ~
{ ( @3 L3 r8 ^, a8 j8 J
L+ E8 n8 k! X
sqlite3 * db = NULL; //聲明sqlite關鍵結構指針7 }7 M) d; q( W. R" h0 F0 Z* {
Q6 B! h0 O4 _, B! m2 B
int result;/ } d( t( t3 R0 C# P; M
4 j1 @7 j' S/ b* V% L8 ]
1 s4 M: ` _+ D4 ]- d+ u
//打開數據庫 : x! T7 u, e" v0 e; O
//需要傳入 db 這個指針的指針，因爲 sqlite3_open 函數要爲這個指針分配內存，還要讓db指針指向這個內存區
- R* r0 Z% t3 q
result = sqlite3_open( “c:\\Dcg_database.db”, &db ); / j% C H2 j: Z/ Z$ Q
9 h3 J3 r% G& V6 e- A8 B
if( result != SQLITE_OK )
{
9 M+ m) p- b8 } f% g
//數據庫打開失敗
return -1;
9 T+ Z4 U. V- m j6 f7 g/ j- V$ J
}
3 T/ P) l! W) O3 |! N
//數據庫操作代碼0 [/ Y6 a- U# i0 l$ }
6 f: \, A& D3 y3 ^
//…
" e! U9 q5 J7 ]; m( M3 x3 `
& x0 c. l4 ~. V8 \; H2 G$ P
% Q! U1 S5 B9 Y, O& S7 ?. A/ r, d
//數據庫打開成功; t1 I. U6 ^& i! E1 P5 M% M5 E: s
/ ^) j8 R+ c8 B4 i
//關閉數據庫
sqlite3_close( db ); " J/ r1 Y4 f L. ?6 e7 [+ T0 f% d. d
; E. h; c. x9 s
return 0;
# A0 c& _4 I6 |' p3 u5 b, I
}
這就是一次數據庫操作過程。
（2） SQL語句操作
本節介紹如何用sqlite 執行標準 sql 語法。
; K; g( A* p; ^
) X# l2 r, F. b
i.1 執行sql語句
複製內容到剪貼板
這就是執行一條 sql 語句的函數。代碼:
int sqlite3_exec(sqlite3*, const char *sql, sqlite3_callback, void *, char **errmsg );第1個參數不再說了，是前面open函數得到的指針。說了是關鍵數據結構。
) l) J9 c# u) I( Z0 z; ~( `5 l
第2個參數const char *sql 是一條 sql 語句，以\0結尾。/ R. Y% p. }* l' f' D' y4 ~& Z' {
- Y2 Z2 k+ w. L! ]- U
第3個參數sqlite3_callback 是回調，當這條語句執行之後，sqlite3會去調用你提供的這個函數。（什麼是回調函數，自己找別的資料學習）+ J9 U! {7 L9 ?% c; m3 H0 k
# Z% E2 z9 b: c$ I# \
第4個參數void * 是你所提供的指針，你可以傳遞任何一個指針參數到這裏，這個參數最終會傳到回調函數裏面，如果不需要傳遞指針給回調函數，可以填NULL。等下我們再看回調函數的寫法，以及這個參數的使用。; P3 q$ m; M n# Y5 E2 Z
: g, }0 i* T% g! K- {
第5個參數char ** errmsg 是錯誤信息。注意是指針的指針。sqlite3裏面有很多固定的錯誤信息。執行 sqlite3_exec 之後，執行失敗時可以查閱這個指針（直接 printf(“%s\n”,errmsg)）得到一串字符串信息，這串信息告訴你錯在什麼地方。sqlite3_exec函數通過修改你傳入的指針的指 針，把你提供的指針指向錯誤提示信息，這樣sqlite3_exec函數外面就可以通過這個 char*得到具體錯誤提示。0 e: g: \% Q, z
說明：通 常，sqlite3_callback 和它後面的 void * 這兩個位置都可以填 NULL。填NULL表示你不需要回調。比如你做 insert 操作，做 delete 操作，就沒有必要使用回調。而當你做 select 時，就要使用回調，因爲 sqlite3 把數據查出來，得通過回調告訴你查出了什麼數據。
1 |9 d9 b6 |- }& o
i.2 exec 的回調
複製內容到剪貼板
你的回調函數必須定義成上面這個函數的類型。下面給個簡單的例子：代碼:
typedef int (*sqlite3_callback)(void*,int,char**, char**);& L5 D: S* \3 g7 R; J9 I8 o5 q
//sqlite3的回調函數
// sqlite 每查到一條記錄，就調用一次這個回調
複製內容到剪貼板
代碼:
int LoadMyInfo( void * para, int n_column, char ** column_value, char ** column_name )
{
//para是你在 sqlite3_exec 裏傳入的 void * 參數
//通過para參數，你可以傳入一些特殊的指針（比如類指針、結構指針），然後在這裏面強制轉換成對應的類型（這裏面是void*類型，必須強制轉換成你的類型纔可用）。然後操作這些數據
//n_column是這一條記錄有多少個字段 (即這條記錄有多少列)
// char ** column_value 是個關鍵值，查出來的數據都保存在這裏，它實際上是個1維數組（不要以爲是2維數組），每一個元素都是一個 char * 值，是一個字段內容（用字符串來表示，以\0結尾）
//char ** column_name 跟 column_value是對應的，表示這個字段的字段名稱
//這裏，我不使用 para 參數。忽略它的存在.
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 )
{
//數據庫打開失敗
return -1;
}
//數據庫操作代碼
//創建一個測試表，表名叫 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( “創建表失敗，錯誤碼:%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 );
}
//開始查詢數據庫
result = sqlite3_exec( db, “select * from MyTable_1”, LoadMyInfo, NULL, errmsg );
//關閉數據庫
sqlite3_close( db );
return 0;
}
