iOS 同樣支援 SQLite。目前有許多第三方封裝,例如以 Swift 撰寫的 SQLite.swift,蘋果自己也提供了 Core Data 框架,但它們底層都離不開 SQLite。本文說明如何在 Swift 專案中直接呼叫原生的 SQLite C API。
建立 Swift 專案後,需要讓專案連結 sqlite 的函式庫:
1. 開啟專案設定,選擇 Build Phases。

2. 展開 Link Binary With Libraries,點 + 號,在彈窗中輸入 sqlite3 並加入。

完成後:

3. 建立橋接檔:在專案目錄下新增一個 Objective-C 標頭檔。

4. 在該標頭檔中引入 sqlite:
#import "sqlite3.h"

5. 最後在 Build Settings 中搜尋 swift,找到 Objective-C Bridging Header,填入剛才建立的橋接檔名稱。

設定完成後可以驗證:在 Swift 檔中輸入 sqlite3,若有相關的自動完成提示,代表引入成功。
使用 sqlite3_open 即可。我們不需手動建立資料庫檔——若檔案不存在,這個方法會自動幫我們建立再開啟。
// 資料庫存放路徑
let sqlitepath = NSHomeDirectory().stringByAppendingPathComponent("Documents/sqlite3.db")
// 開啟資料庫;檔案不存在時會先建立再開啟
let state = sqlite3_open(sqlitepath, &db)
if state == SQLITE_OK {
print("打開數據庫成功")
} else {
print("打開數據庫失敗")
}
第二個參數是一個指標,代表開啟後的操作 handle,後續所有運算都靠它進行。由於多個方法都要用到,建議宣告為=""> 屬性方便取用:
var db: COpaquePointer = nil
用 sqlite3_exec 執行整段 SQL,差異只在 SQL 本身:
// 建立表
let createtable = "create table if not exists students (id integer primary key autoincrement, name text, stuId integer)"
let result = sqlite3_exec(db, createtable, nil, nil, nil)
if result == SQLITE_OK {
print("創建表成功")
}
// 刪除表
let removetable = "drop table studets"
let result2 = sqlite3_exec(db, removetable, nil, nil, nil)
if result2 == SQLITE_OK {
print("刪除表成功")
}
帶參數時使用 ? 佔位符,再用 sqlite3_bind_xxx 綁定實際值,這能有效避免 SQL injection:
let inserttable = "insert into studets (stuId, name) values(?, ?)"
var statement: COpaquePointer = nil
let result3 = sqlite3_prepare_v2(db, inserttable, -1, &statement, nil)
if result3 == SQLITE_OK {
sqlite3_bind_int(statement, 1, 1)
sqlite3_bind_text(statement, 2, "lijialong", -1, nil)
if sqlite3_step(statement) == SQLITE_DONE {
print("數據插入成功")
}
sqlite3_finalize(statement)
}
更新:
let updatetable = "update studets set name = 'ss' where id = 1" var statement: COpaquePointer = nil sqlite3_prepare_v2(db, updatetable, -1, &statement, nil) sqlite3_step(statement) sqlite3_finalize(statement)
刪除:
let deleterow = "delete from studets where name = 'lijialong'" sqlite3_prepare_v2(db, deleterow, -1, &statement, nil) sqlite3_step(statement) sqlite3_finalize(statement)
let query = "select * from studets"
// 執行後資料就在 statement 中
sqlite3_prepare_v2(db, query, -1, &statement, nil)
// 游標往下走一步,回傳 SQLITE_ROW 就進入迴圈
while sqlite3_step(statement) == SQLITE_ROW {
let id = sqlite3_column_int(statement, 0)
let stuId = sqlite3_column_int(statement, 2)
}
補充幾點實務提醒:新版 Swift 已在 Foundation 中直接提供 SQLite3 相關型別別名,可省去自建橋接檔;sqlite3_bind_text 的第 4 個參數傳 -1 代表自動計算長度,第 5 個參數傳 nil 表示使用預設的釋放方式;而 sqlite3_finalize 務必在每次 statement 使用完畢後呼叫,否則長時間執行會累積資源耗用。若資料庫操作頻繁,建議把連線與 statement 生命週期封裝成獨立的管理類,並搭配佇列確保執行緒安全。