FMDB 是 iOS 平台上針對 SQLite 的資料庫框架,本質上是以 Objective-C 的方式把 SQLite 的 C 語言 API 重新包裝了一層。
它解決了什麼問題?
原生 SQLite 的 C API 寫起來繁瑣且容易出錯:語句要自己拼、參數要綁定、結果集要一欄一欄取值。FMDB 讓整個過程變得物件導向,省下大量冗餘的 C 程式碼。
相較於 Apple 自帶的 Core Data,FMDB 更輕量、更靈活,SQL 語句全由你掌控。
此外,它還提供了多線程安全的資料庫操作方式,能有效避免資料錯亂。
專案位址:https://github.com/ccgus/fmdb
FMDatabase:一個 FMDatabase 物件代表一個獨立的 SQLite 資料庫,所有 SQL 語句都透過它執行。
FMResultSet:執行查詢後得到的結果集,用 next 逐列遍歷。
FMDatabaseQueue:用於在多線程環境中執行多個查詢或更新,它天生是線程安全的。
透過指定 SQLite 檔案路徑來建立 FMDatabase 物件:
FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
NSLog(@"資料庫打開失敗!");
}
路徑有三種常見情形:
在 FMDB 的語彙裡,除了查詢以外的所有操作都統稱「更新」——create、drop、insert、update、delete 都算。
- (BOOL)executeUpdate:(NSString*)sql, ... - (BOOL)executeUpdateWithFormat:(NSString*)format, ... - (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments
範例:
[db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @20, @"Jack"];
用 ? 作為參數佔位符,能有效避免拼接字串造成的 SQL 注入風險。
- (FMResultSet *)executeQuery:(NSString*)sql, ... - (FMResultSet *)executeQueryWithFormat:(NSString*)format, ... - (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments
範例:
// 查詢資料
FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];
// 遍歷結果集
while ([rs next]) {
NSString *name = [rs stringForColumn:@"name"];
int age = [rs intForColumn:@"age"];
double score = [rs doubleForColumn:@"score"];
}
先建立專案,加入 libsqlite3 庫並引入主標頭檔:

接著下載第三方框架 FMDB:

// // YYViewController.m // 04-FMDB基本使用 // #import "YYViewController.h" #import "FMDB.h" @interface YYViewController () @property (nonatomic, strong) FMDatabase *db; @end
@implementation YYViewController
- (void)viewDidLoad
{
[super viewDidLoad];
// 1. 取得資料庫檔案路徑
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"student.sqlite"];
// 2. 取得資料庫
FMDatabase *db = [FMDatabase databaseWithPath:fileName];
// 3. 打開資料庫
if ([db open]) {
// 4. 建表
BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
if (result) {
NSLog(@"創表成功");
} else {
NSLog(@"創表失敗");
}
}
self.db = db;
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
[self delete];
[self insert];
[self query];
}
// 插入資料
- (void)insert
{
for (int i = 0; i < 10; i++) {
NSString *name = [NSString stringWithFormat:@"jack-%d", arc4random_uniform(100)];
// executeUpdate: 不確定的參數用 ? 佔位
[self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);",
name, @(arc4random_uniform(40))];
// 也可以改用 withArgumentsInArray:
// [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);"
// withArgumentsInArray:@[name, @(arc4random_uniform(40))]];
// executeUpdateWithFormat: 不確定的參數用 %@、%d 等佔位
// [self.db executeUpdateWithFormat:@"INSERT INTO t_student (name, age) VALUES (%@, %d);",
// name, arc4random_uniform(40)];
}
}
// 刪除資料
- (void)delete
{
// [self.db executeUpdate:@"DELETE FROM t_student;"];
[self.db executeUpdate:@"DROP TABLE IF EXISTS t_student;"];
[self.db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
}
// 查詢
- (void)query
{
// 1. 執行查詢語句
FMResultSet *resultSet = [self.db executeQuery:@"SELECT * FROM t_student"];
// 2. 遍歷結果
while ([resultSet next]) {
int ID = [resultSet intForColumn:@"id"];
NSString *name = [resultSet stringForColumn:@"name"];
int age = [resultSet intForColumn:@"age"];
NSLog(@"%d %@ %d", ID, name, age);
}
}
@end
執行結果:

小提示:如果把 id 設為 autoincrement 的自動增長主鍵,那麼在清空資料表後重新插入,ID 並不會從 1 重新開始,而是接續先前的最大值遞增。
要注意:使用 executeUpdateWithFormat: 時,字串參數請直接寫 %@,不要自己加上單引號。

同樣需要先導入 FMDB 框架與標頭檔;由於它依賴 libsqlite 庫,這個庫也要一併加入。

// // YYViewController.m // 05-FMDB資料庫隊列 // #import "YYViewController.h" #import "FMDB.h" @interface YYViewController () @property (nonatomic, strong) FMDatabaseQueue *queue; @end
@implementation YYViewController
- (void)viewDidLoad
{
[super viewDidLoad];
// 1. 取得資料庫檔案路徑
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"person.sqlite"];
// 2. 取得資料庫隊列
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:fileName];
// 3. 透過隊列操作資料庫
[queue inDatabase:^(FMDatabase *db) {
BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
if (result) {
NSLog(@"創表成功");
} else {
NSLog(@"創表失敗");
}
}];
self.queue = queue;
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
// 插入資料
// [self.queue inDatabase:^(FMDatabase *db) {
// [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
// }];
// 查詢資料
[self.queue inDatabase:^(FMDatabase *db) {
// 1. 執行查詢語句
FMResultSet *resultSet = [db executeQuery:@"SELECT * FROM t_person"];
// 2. 遍歷結果
while ([resultSet next]) {
int ID = [resultSet intForColumn:@"id"];
NSString *name = [resultSet stringForColumn:@"name"];
int age = [resultSet intForColumn:@"age"];
NSLog(@"%d %@ %d", ID, name, age);
}
}];
}
@end
先插入資料再查詢,輸出如下:

隊列帶來的好處。有了隊列物件之後,它內部會自動持有並管理一個資料庫物件,而且所有操作都是線程安全的。

沒有事務機制,某些操作會出問題。最經典的例子是銀行轉帳:

張三和李四帳戶都有 1000 塊錢。張三要轉帳給李四,需要執行兩條 SQL。基於安全性考量,這兩條語句要嘛全部成功,要嘛全部失敗——絕不能出現「錢扣了但沒入帳」的狀態。
事務就是把多條語句綁在同一個單元裡執行,要嘛全成功,要嘛全失敗;中途出問題時會自動回滾。這特性稱為原子性。
把多條語句放進同一個事務:
// 插入資料
[self.queue inDatabase:^(FMDatabase *db) {
[db beginTransaction];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @25];
[db commit];
}];
若中途出錯會自動回滾,也可以選擇手動回滾:
// 插入資料
[self.queue inDatabase:^(FMDatabase *db) {
[db beginTransaction];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
[db rollback];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @25];
[db commit];
}];
上面這段程式碼裡,前三條插入語句因為回滾而全部作廢。
事務還有另一種更簡潔的寫法:
[self.queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
[db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
}];
說明:這個 block 會自動幫你開啟事務、執行其中的程式碼,最後提交事務,省去手寫 beginTransaction 與 commit 的麻煩。