SQLite 是 iOS 上最主流的輕量級資料庫選擇。它以純 C 實作,因此天生跨平台——Android 與 iOS 都能使用,甚至能寫出幾乎完全通用的程式碼,移植成本極低。雖然各平台都提供了封裝好的 API,但直接用原生 C 介面有兩個好處:一是便於跨平台共用,二是能完全掌握底層行為(效能如何、要不要加自己的加密層或回呼函式,都由你決定)。
在 iOS 上最省事——Apple 的 SDK 已經內建 SQLite,你只要手動加入對應的 framework 即可。
操作步驟:點擊專案設定中的「+」按鈕,搜尋 sqlite3,選取 libsqlite3.0.dylib(部分 Xcode 版本顯示為 libsqlite3.tbd),按下 Add。



接著在需要使用的檔案中引入標頭檔:

#import "sqlite3.h"
若是在其他平台(Android、嵌入式 Linux)使用,則需要自行下載原始碼。到 sqlite.org 的 download 頁面取得 sqlite-amalgamation-xxxx.zip,解壓後裡頭會有 sqlite3.c 與 sqlite3.h 兩個檔案,直接拖進專案即可。這種做法比連結預編譯好的靜態庫更方便除錯,也能讓你自由增減功能——例如自行加入一層加密、掛上自訂回呼函式,或刪掉用不到的模組以精簡程式碼體積。
本文以下範例皆以純 C 撰寫,雖然開發環境是 Xcode,但除了庫的引用方式不同之外,其餘程式碼在 iOS 與 Android 上完全通用。
SQLite 的型別系統非常精簡,只有五種儲存類別:
每個大類底下還會依資料長度細分若干子型別,但實務上直接使用這五個大類即可,細節在實際操作中慢慢熟悉就好。
值得注意的是,SQLite 採用動態型別(dynamic typing),並不強制你預先宣告欄位型別,寫入時會依實際值自動轉換。不過為了查詢效率與資料品質,仍強烈建議明確標註型別。
以下用一個建立表的 SQL 說明型別的實際用法:
CREATE TABLE student (
name TEXT, -- 姓名
no INTEGER, -- 學號
totalScore REAL, -- 總分
photo BLOB -- 照片
);
要操作資料庫,你得先取得它的句柄(handle)。這個詞聽起來抽象,其實概念很單純:句柄就是一個描述某個物體的結構體,裡頭放著位置、大小、型別等資訊,讓你能定位並操作它。
最常見的例子是檔案句柄——要讀寫檔案,先取得檔案句柄。同樣的道理,要操作資料庫,先取得資料庫句柄。這就像「鞋子」為什麼叫鞋子,糾結名稱意義不大,理解它的功能才是重點。
SQLite 的句柄定義在 sqlite3 結構體中。這個結構體非常龐大(包含 VFS 介面、錯誤碼、鎖定狀態、頁面快取、交易資訊、各種回呼函式指標等數十個欄位),初學階段完全不需要讀懂,直接跳過即可:
struct sqlite3 {
sqlite3_vfs *pVfs; /* OS Interface */
int nDb; /* Number of backends currently in use */
Db *aDb; /* All backends */
int flags; /* Miscellaneous flags */
unsigned int openFlags; /* Flags passed to sqlite3_vfs.xOpen() */
int errCode; /* Most recent error code (SQLITE_*) */
/* ...(此處省略數十個內部欄位)... */
};
typedef struct sqlite3 sqlite3;
這段程式碼貼出來的唯一目的,就是為了破除你對「句柄」的恐懼感。你只需要知道:sqlite3 這個結構體用來描述磁碟上的資料庫檔案,有了這個描述符就能對資料庫進行各種操作。操作的內部細節暫時不必深究,先把 API 用熟,日後遇到效能或交易問題再回頭研究。
真正寫起來,建立句柄只有一行:
sqlite3 *pdb;
就這麼簡單。之後所有針對資料庫的動作——開檔、建表、交易、查詢、關檔——都會圍繞著這個 pdb 進行。
後續文章將接著說明 sqlite3_open()、sqlite3_exec() 與 sqlite3_prepare_v2() 這三個最核心的 API,以及如何自行封裝出一層好用的 Objective-C 介面。