在 iOS 中,SQLite 是常見的本機資料庫方案。原生 SQLite API 使用 C 語言介面,操作起來較繁瑣。FMDB 則以 Objective-C 封裝 SQLite,讓開發者能以更貼近 iOS 開發習慣的方式進行資料存取。
FMDB 的主要優點是易用、輕量,並對多執行緒存取做了處理。它把資料庫操作包裝成物件方法,讓查詢、插入、更新與刪除更直觀。
與直接使用 SQLite C API 相比,FMDB 減少了大量瑣碎設定。它適合用於需要本機儲存、離線資料、快取資料或複雜查詢的 App。

FMDB 使用流程
FMDatabase 代表一個 SQLite 資料庫,負責開啟、關閉與執行 SQL。FMResultSet 表示查詢結果集,可用來遍歷資料列。FMDatabaseQueue 則用於多執行緒環境,提供佇列化的資料庫操作。
在一般情況下,不建议多個執行緒共用同一個 FMDatabase 實例。若需要背景執行緒存取資料庫,FMDatabaseQueue 是較安全的選擇。
建立 FMDatabase 時,需要傳入資料庫檔案路徑。路徑可指向實際檔案、空字串或 nil。若傳入檔案路徑且檔案不存在,通常會自動建立。
在操作資料庫前,必須先開啟連線。若開啟失敗,可能是權限不足或資源不足。完成操作後,應關閉資料庫,避免資源洩漏。
建立資料表通常使用 CREATE TABLE 語句。FMDB 的 executeUpdate 方法可用於執行非查詢類 SQL,例如建立、插入、更新、刪除與刪表。

資料模型示意
若需要確認資料表是否建立成功,可在執行後檢查回傳值,或使用 lastErrorMessage 取得錯誤資訊。

使用工具查看 SQLite 檔案

資料表結構
插入資料時,可使用佔位符避免 SQL 注入。常見方式包括使用問號佔位,或使用格式化方法。若參數為原生型別,也可使用格式化佔位符。
刪除資料時,通常依條件刪除,例如依 ID 或名稱。更新資料時,則以條件指定要修改的資料列,並設定新的欄位值。
這些操作都屬於更新類 SQL,執行後會回傳布林值,表示是否成功。若失敗,可透過錯誤碼與錯誤訊息進一步排查。
查詢資料使用 executeQuery 方法,回傳 FMResultSet。若查詢成功,可透過 while 迴圈遍歷結果集。若失敗,通常回傳 nil。
FMResultSet 提供多種型別轉換方法,例如 intForColumn、stringForColumn、doubleForColumn、dataForColumn 等。開發者可依欄位型別取得對應數值。
查詢時可使用條件,例如依 ID 範圍、名稱或其他欄位過濾。若需要動態條件,應使用參數化查詢,避免直接拼接字串。
在多個執行緒中同時使用同一個 FMDatabase 實例,容易造成崩潰或資料競爭。FMDatabaseQueue 會把資料庫操作序列化,讓不同執行緒的請求依序進入資料庫。
使用 FMDatabaseQueue 時,通常會把多個操作包裝成一個區塊,並可設定交易。若其中某個步驟失敗,可回滾交易,避免資料不一致。
使用 FMDB 時,應避免在背景執行緒直接共用同一個資料庫連線。若需要並行讀寫,可考慮 FMDatabaseQueue 或多資料庫連線策略。
此外,SQL 應保持清楚與可讀,查詢結果应及时關閉或釋放。對於大量資料,應考慮分頁、索引與查詢效能。
整體而言,FMDB 讓 SQLite 在 iOS 中的使用變得更簡單。只要掌握資料庫連線、SQL 執行、結果集讀取與執行緒安全,就能穩定地完成本機資料持久化。