SQLite3 的二三事

MAC OS 自從 10.4 起就已經內建 SQLite 這套資料庫軟體， 由於內建的是第三版的 SQLite 所以又稱作是 SQLite3。這裡暫且不管資料庫是如何建立的，因為有太多建立 SQLite3 資料庫的方法，例如使用 Mozilla Filefox 瀏覽器的外掛模組（SQLite Manager） 或是其他包含 GUI 介面的軟體，都是透過 Terminal 終端機來下達 SQLite 的指令，當然你也可以自己使用 Terminal 來建立自己的資料庫。有關 SQLite 的相關語法指令集可以參閱官方網站獲得更多資訊。

環境設定
在環境設定的部份必須先引入 SQLite3 的標頭檔與 Framework（libsqlite3.dylib），如果你已經有現成的 Sqlite 資料庫檔案，則需要將檔案放置專案下的 Resources 內，Xcode 4 則是放入專案名稱資料夾下的 Supporting Files 中。

替專案加入 libsqlite3.dylib

#import <sqlite3.h>
如果是使用 Xcode 4 編譯器的朋友可以參閱 Xcode 4 新增 Framework 的方法來新增。

一切都設定好之後就要開始與資料庫取得聯繫，程式碼如下。


連結資料庫與建立
連結現有 Resources/Supporting Files 中的資料庫

在開始之前先來檢閱一下之後要用到資料庫的內容，這是一個我們使用 Firefox 瀏覽器外掛模組所建立的學生考試資料庫（Exam），裡面包含一個期末考試的表格（Final），表格內有兩個欄位分別是學號（SID）與分數（Score）。

Exam.sqlite 的內容

//設定資料庫檔案的路徑
NSString *url = [[[NSBundle mainBundle]resourcePath] stringByAppendingPathComponent:@"Exam.sqlite"];
sqlite3 *database = nil;

if (sqlite3_open([url UTF8String], &database) == SQLITE_OK) {
    NSLog(@"DB OK");
    //這裡寫入要對資料庫操作的程式碼

    //使用完畢後關閉資料庫聯繫
    sqlite3_close(database);
}


連結或建立其他路徑下的資料庫
除了連結現有的資料庫外，你也可以使用同樣的方式動態產生 Sqlite 資料庫，如果資料庫不存在於路徑下，Sqlite 就會幫你建立該資料庫，下面我們以 iOS 中 Documents 資料夾為例。

NSArray *documentsPath=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *databaseFilePath=[[documentsPath objectAtIndex:0] stringByAppendingPathComponent:@"Exam"];
sqlite3 *database = nil;

if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK) {
    NSLog(@"DB OK");
    //這裡寫入要對資料庫操作的程式碼

    //使用完畢後關閉資料庫聯繫
    sqlite3_close(database);
}

資料庫查詢

程式碼到這裡如果可以成功連結資料庫就會在 Console 印出 DB OK 的字樣。下面我們將對資料庫做兩個簡單的操作取得資料筆數與內容。

//查閱一共有多少筆資料
//建立 Sqlite 語法
const char *sql = "select count(*) from Final";

//statement 將存放查詢結果
sqlite3_stmt *statement =nil;

if (sqlite3_prepare_v2(database, sql, -1, &statement, NULL) == SQLITE_OK) {
    if (sqlite3_step(statement) == SQLITE_ROW) {

        int count = sqlite3_column_int(statement, 0);
        NSLog(@"共有 %d 比資料。", count);
    }

    //使用完畢後將statement清空
    sqlite3_finalize(statement);
}
//查閱所有資料內容
//建立 Sqlite 語法
const char *sql = "select * from Final";

//stm將存放查詢結果
sqlite3_stmt *statement =nil;

if (sqlite3_prepare_v2(database, sql, -1, &statement, NULL) == SQLITE_OK) {
    while (sqlite3_step(statement) == SQLITE_ROW) {

        NSString *sid, *score;

        sid = [NSString stringWithUTF8String:(char *)sqlite3_column_text(statement, 0)];
        score = [NSString stringWithUTF8String:(char *)sqlite3_column_text(statement, 1)];

        NSLog(@"學生: %@ ,分數: %@", sid, score);
    }

    //使用完畢後將statement清空
    sqlite3_finalize(statement);
}


執行結果

上述程式碼中 sqlite3_column_text 帶入參數 0 或是 1 分別是對應兩個表格中的欄位（學號與分數），另一種方式，可以考慮把擷取回來的資料作成物件放入 NSMutableArray 中，方便之後讀取與修改。

建立表格與輸入資料

在這部份我們動態產生一份與使用 Firefox 瀏覽器外掛模組所建立的學生考試資料庫（Exam）完全一樣內容的資料表，請看以下程式碼。

//建立表格
char *errorMsg;
const char *createSql="create table if not exists Final (SID integer primary key autoincrement, Score text)";

if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
    NSLog(@"TABLE OK");
    //建立成功之後要對資料庫操作的程式碼

    } else {
    //建立失敗時的處理
    NSLog(@"error: %s",errorMsg);

//清空錯誤訊息
    sqlite3_free(errorMsg);
}
//插入資料
char *insertErrorMsg;

//建立 Sqlite 語法
const char *insertSql="insert into Final (Score)values('80')";
if (sqlite3_exec(database, insertSql, NULL, NULL, &insertErrorMsg)==SQLITE_OK) {
    NSLog(@"INSERT OK");
}
insertSql="insert into Final (Score)values('70')";
if (sqlite3_exec(database, insertSql, NULL, NULL, &insertErrorMsg)==SQLITE_OK) {
    NSLog(@"INSERT OK");
}
insertSql="insert into Final (Score)values('90')";
if (sqlite3_exec(database, insertSql, NULL, NULL, &insertErrorMsg)==SQLITE_OK) {
    NSLog(@"INSERT OK");
}
insertSql="insert into Final (Score)values('85')";
if (sqlite3_exec(database, insertSql, NULL, NULL, &insertErrorMsg)==SQLITE_OK) {
    NSLog(@"INSERT OK");
}
insertSql="insert into Final (Score)values('95')";
if (sqlite3_exec(database, insertSql, NULL, NULL, &insertErrorMsg)==SQLITE_OK) {
    NSLog(@"INSERT OK");
}

查詢上述動態產生資料庫的執行結果