Swift - 操作SQLite数据库(引用SQLite3库)
作者:hangge | 2015-03-06 09:27
SQLite轻量级数据库在移动应用中使用非常普遍,但是目前的库是C编写的,为了方便使用,对SQLite相关的操作用Swift进行了封装。这个封装代码使用了一个开源项目SQLiteDB,地址是:https://github.com/fahimf/sqlitedb
重要事项(2015-09-25日):SQLiteBD原作者最后只更新到Swift1.2便停止,说后面不会再更新了,如果使用Xcode7便会报错。我这里在其基础上进行了修改,使其支持Swift2.0。
MySQLite2.zip
老代码下载(官方支持Swift2):
MySQLite3.zip
参考我的另一篇文章:Swift - SQLite中Data类型数据的插入、读取(BLOB类型字段)
重要事项(2015-09-25日):SQLiteBD原作者最后只更新到Swift1.2便停止,说后面不会再更新了,如果使用Xcode7便会报错。我这里在其基础上进行了修改,使其支持Swift2.0。
重要事项(2015-11-23日):SQLiteBD原作者又继续更新了,现在已经完美支持Swift2.0。所以大家可以直接使用,本文使用样例也已同步更新。
重要事项(2016-10-31日):SQLiteBD库已经升级至Swift3,本文使用样例也已同步更新。

老代码下载(个人修改的支持Swift2.0):重要事项(2016-10-31日):SQLiteBD库已经升级至Swift3,本文使用样例也已同步更新。
下面通过一个样例展示SQlite数据库连接,创建表,查询数据,插入数据等操作。
1,当输入用户名和手机号,点击保存即可将数据存入数据库
2,下次启动,自动从数据库中载入初始化信息

操作步骤:
1,在 Build Phases -> Link Binary With Libraries 中点击加号,添加 libsqlite3.0.tbd 到项目中来

2,创建连接头文件Bridging-Header.h
#import "sqlite3.h" #import <time.h>3,在项目编译属性里引用头文件

4,导入SQLiteDB的代码(SQLiteDB.swift、SQLTable.swift),代码结构如下:

5,ViewController.swift代码
import UIKit
class ViewController: UIViewController {
var db:SQLiteDB!
@IBOutlet var txtUname: UITextField!
@IBOutlet var txtMobile: UITextField!
override func viewDidLoad() {
super.viewDidLoad()
//获取数据库实例
db = SQLiteDB.shared
//打开数据库
_ = db.openDB()
//如果表还不存在则创建表(其中uid为自增主键)
let result = db.execute(sql: "create table if not exists t_user(uid integer primary key,uname varchar(20),mobile varchar(20))")
print(result)
//如果有数据则加载
initUser()
}
//点击保存
@IBAction func saveClicked(_ sender: AnyObject) {
saveUser()
}
//从SQLite加载数据
func initUser() {
let data = db.query(sql: "select * from t_user")
if data.count > 0 {
//获取最后一行数据显示
let user = data[data.count - 1]
txtUname.text = user["uname"] as? String
txtMobile.text = user["mobile"] as? String
}
}
//保存数据到SQLite
func saveUser() {
let uname = self.txtUname.text!
let mobile = self.txtMobile.text!
//插入数据库,这里用到了esc字符编码函数,其实是调用bridge.m实现的
let sql = "insert into t_user(uname,mobile) values('\(uname)','\(mobile)')"
print("sql: \(sql)")
//通过封装的方法执行sql
let result = db.execute(sql: sql)
print(result)
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
老代码下载(只支持Swift1.2):
MySQLite.zip
老代码下载(官方支持Swift2):
具体错误信息:“SQLiteDB - failed to copy writable version of DB!
Error - The file “data.db” couldn’t be opened because there is no such file.”
解决办法:你需要在 “工程” -> “Build Phases” -> “Copy Bundle Resources” 中把这个数据库添加进来。这样才能将其随同程序一起部署到手机上。
解决办法:你需要在 “工程” -> “Build Phases” -> “Copy Bundle Resources” 中把这个数据库添加进来。这样才能将其随同程序一起部署到手机上。

(2)execute()方法执行后的返回值表示什么
execute() 方法可以用来执行任何非查询的 SQL 语句(INSERT、DELETE、UPDATE、CREATE 等等),其执行后返回的是一个 CInt 类型的值。- 返回 0 表示执行失败
- 返回非 0 表示执行成功 (一般是1。如果是 INSERT 命令的话返回的是新插入记录的 ID。DELETE、UPDATE比较特殊,返回的是操作影响的记录数,但如果一条记录都没影响,返回的也是 1。)
全部评论(39)
航哥,您好,到目前为止您可以忽略我前面的提问,非常非常不好意思,因为经过一段时间的试验和读代码,我发现问题的核心是db.execute(sql: sql)这条语句,我在SQLiteDB.swift的源码中看到这个函数会进一步调用Private func execute(stmt:OpaquePointer, sql:String)->Int {...}这个函数,而这个函数内部对于插入操作和更新操作又分别调用了sqlite3_last_insert_rowid(self.db)和sqlite3_changes(self.db)这两个函数,但是对于像删除表和修改表(drop table table_name 和alter table table_name add column_name column_type )这样的SQL语句却没有调用专门的函数,然后我就试着写了alter table..之类的语句来测试使用execute(sql)是否起作用,结果是起作用了,它更改了表的结构,但是让我很疑惑,它没有调用专门的函数啊,它是怎么达到这样的效果的呢?
站长回复:不好意思刚看到你的留言。我其实也没有仔细研究过SQLiteDB里面的代码,所以这里就没法解答你的疑问。倒是我要谢谢你反馈了这么多信息,让我更了解里面的机制。
hangge,您好,刚刚我提到没有测出问题,但是又测了下,发现在重新保存数据的时候会出现问题,报错(ERROR: table persons has no column named passWord)现在想到的方法是加入alter SQL语句来协助修改表的结构,但是那个SQLiteDB中好像没有,感觉需要自己写。。我再研究下他的代码。
站长的意思是每次用这个库的时候就得先自己手动创建一个data.db添加进去?
站长回复:是这样的,SQLiteBD只是一个封装好的数据库操作框架,你要提供数据库给它操作才行。
我很确定Copy Bundle Resources里面有
站长回复:那就奇怪了,我也不知道是什么问题了。
我添加了data.db 但是还是报错SQLiteDB - failed to copy writable version of DB! Error - The file “data.db” couldn’t be opened because there is no such file.
站长回复:你检查下“Copy Bundle Resources”中有没有把data.db添加进来。
站长,找到了!谢谢你!
站长回复:不客气。
您好,我是自己建的工程,然后建的一个空的data.db放进了工程所在的文件夹里面,可以插入数据之类的而且插入之后的确可以查询得到,但是那个data.db一直都是空的呢什么东西都没有?而且那个工程里面除了这个db文件没有别的bd文件了呀??
站长回复:数据保存在App沙盒目录下的data.db文件(程序运行后从工程项目中自动复制过来的,工程里的那个data.db肯定是0字节)
您好,我想请教一下,我要往数据库里存放图片,图片转了data,直接插入数据库了,读出来就是一串字符,不能再被转为图片了,在网上搜不到相关的解决办法,求demo。
站长回复:应该是你插入时就不对了,你可看下我的这篇文章,里面有完整的样例。Swift - SQLite中Data类型数据的插入、读取(BLOB类型字段)
您好,请问一下,发现程序执行的确是成功建表并且可以插入数据,但是在data.db里却看不到任何数据,请问那些数据是到了哪里呀?是在另外的文件里面嘛??
站长回复:是在App沙盒目录下的data.db文件。(不是工程里的那个data.db,那个肯定是0字节)
写的真好,谢谢分享
站长回复:不客气,谢谢你的夸奖。
谢谢站长,问题已解决,之前确实看的是工程里的data.db(手动尴尬)
站长回复:不客气,找到原因就好。
话说,删除某一个数据,怎么删?
站长回复:删除同样使用execute()方法执行删除语句,比如:
db.execute(sql: "delete from t_user where uname='hangge'")
站长,我用你的demo运行成功了,但是data.db文件始终是0字节,打开后也什么都没有,不清楚是什么原因
站长回复:你确定看的的是App沙盒目录下的data.db文件吗?(不是工程里的那个data.db,那个肯定是0字节)
站长你好,这个在创建表格之前是否要打开数据库?还有就是创建表格返回的CInt类型,等于0就是创建失败,不等0就是创建成功吗?
站长回复:1,不管创建表还是进行其他数据库操作,都是先要通过SQLiteDB.sharedInstance获取实例的(其内部已经自动连接打开数据库了)
站长好,uname这个列名称怎么改不了,还有如果要把表中的数据调出来传入一个数组应该怎么操作
站长回复:(1)你用工具打开data.db就可以改了。
data.db是在哪里获取的?
站长回复:你可以自己用sqlite工具创建个。
你好我按照你的步骤自己创建了一个工程 模拟器没有问题但是真机的话就出现了问题Database path: /var/mobile/Containers/Data/Application/11D85DBE-B3B8-43EE-8563-CB8EE86AA271/Documents/data.db
SQLiteDB - failed to copy writable version of DB!
Error - The file “data.db” couldn’t be opened because there is no such file.
SQLiteDB - failed to prepare SQL: select * from t_user, Error: out of memory
站长回复:你没把data.db一起部署到手机上。具体可以看我在文章末尾新添加的“常见问题”相关内容。
请问 self.db = SQLiteDB.sharedInstance(gid: String) 这个gid应该怎么填,我复制了您的data.db到了项目文件,然后给gid传入了data.db的绝对路径,然后就是报错。求指导,最好给个具体的gid写法。
站长回复:gid指的是GroupIdentifier,这个作用是让group下的app共享同一份读写空间,以实现数据共享。不是用来传data.db路径进去的。
我们通常使用的话不需这个参数,直接self.db = SQLiteDB.sharedInstance()就可以了。默认加载的就是data.db这个数据库文件。(具体你可以进SQLiteDB类里面看看。)
我是长颈鹿,
经过排查, 是我调用OC中的webservice出现内存泄露,leak里面把泄露点指向了CString。 站长提供的代码是没有问题的
站长回复:哦,原来如此。谢谢你的反馈。
谢谢分享, 请问一下站长
在SQLiteDB.swift类中, 525行 有如下代码
let buf = UnsafePointer<Int8>(sqlite3_column_text(stmt, index))
let val = String.fromCString(buf)
return val
我的leak检测工具一直说这里有内存泄露, 请问如何修改
站长回复:这里会内存泄漏?还真没注意。看了下也不知道要怎么改,等作者后面更新看会不会修复这个问题吧。
请问下航哥,用什么语句查询数据表中是否存在某个特定的值字段?
站长回复:如果是sqlite的话,没有直接获取到列名的办法。不过你可以先获取到数据表的建表语句,再从建表语句中查找字段名(列名)
您好!我想请问您 这个 //获取数据库实例
db = SQLiteDB.sharedInstance() 这个实例位置在哪 我想通过其他程序手动去改这个库 可是一直找不到它 谢谢!
站长回复:SQLiteDB.swift 这里面有指定默认数据库是:data.db,运行时这个会复制到Documents目录下
楼主 楼主 为什么我添加以后 像var db:SQLiteDB! 这种涉及到SQLITE的都会报错 Use of undeclared type 'SQLiteDB' 我加了桥接头文件 也添加了那三个文件
站长回复:我又从新创建个工程试了下,按123流程来是没问题的。所以我也不清楚你那边是什么情况了。
您好关于 data.db文件创建的时候sqlitemanager里只找到 .sqlite文件,.db的是在sqlitemanager的什么位置创建啊?望站长不吝赐教
站长回复:这个是同一个东西,你把 文件后缀从.sqlite改成.db试试看,应该是可以用的。
楼主真是不错 学习了
站长回复:谢谢你的支持和鼓励,欢迎常来。
lz, 针对此处的demo那个data.db除了拷贝你的data.db或者用数据库工具创建,还有其他方法吗? 实际项目中那个data.db是怎么来的?
站长回复:实际开发中也是先使用工具创建好数据库,然后放到应用中使用。(数据库中的表一般也是使用工具提前建好的)
为甚么没有增上改查请站长帮助
站长回复:SQLite的增删改查用的就是标准的sql语句,同其它的数据库区别不大。文章里其实有insert,select样例了,update、delete就不再写了。网上搜一下就能找到很多。毕竟本文主要介绍Swfit如何操作SQLite,而不是sql语言教程。
"select user_type from user_info where user_name='\(username)' and user_password='\(password)'"
怎么返回查找到user_type内容啊
站长回复:let data = db.query("select user_type from user_info where user_name='\(username)' and user_password='\(password)'")
if data.count > 0 {
let user_type = data[0]["user_type"]!
}
请问这个要实现自增列怎么实现.
站长回复:建表的时候把这个字段设为integer primary key即可。(样例里的uid就是自增主键,每次插入数据它会自动+1)
多条件查询怎么写总是报错
站长回复:我随便测试了下多条件查询也是没问题的啊。
let data = db.query("select * from t_user where uname = '123' and mobile = 'ttt555' ")
你好、我使用的时候出现SQLiteDB - failed to copy writable version of DB!
Error - 未能打开文件“data.db”,因为它不存在。 我看你的工程里是有这个data.db文件没看到代码在哪创建的、我拷过去也是不行、请问我该怎么创建这个data.db
站长回复:这个db文件是我使用SQLite Manager来创建的,这是一个很好用的SQLite管理工具,你可以下载个试试。
如果直接用我工程里的data.db应该也没问题的,你打开项目文件夹跟我的样例比较下,看下是不是路径问题。
db.execute(sql) 这样执行sql之后就把数据插入数据库了么? 为什么我没有插入数据库呢 别的都没问题了。
站长回复:db.execute(sql)执行后就可以了。不太确定你是什么原因,执行插入语句有报错吗,插入完执行查询语句也是空的吗。
SQLiteDB(SQLTable.swift), func values() 在Swift1.x中实现
我用的是Xcode6.4,也就是不支持Swift 2.0+,现在使用新提供的SQLTable.swift,无法完成编译,无法编译代码如下:
private func values() -> [String:AnyObject] {
var res = [String:AnyObject]()
let obj = Mirror(reflecting:self)
for (_, attr) in obj.children.enumerate() {
if let name = attr.label {
res[name] = getValue(attr.value as! AnyObject)
}
}
return res
}
求大神提供Swift 1.x 代码?
站长回复:因为Swift2.0已经出来挺长时间了,像我原来写的文章代码如果在Swift2中有变化,也会慢慢修改成Swift2版的。相反,不会特地将SQLTable.swift从Swift2版本翻译回Swift1,不好意思啊。
版主謝謝分享
^^
站长回复:不客气,欢迎常来看看
想使用现有数据库,如何配置data.db路径?
站长回复:SQLiteDB的init()方法可以带Group ID,通过开启App Groups可以实现扩展(Extension)和容器应用(Containing App)之间的数据共享
还有个问题,data.db是怎么新建的呢?
站长回复:这个可以自己找个sqlite工具创建。我用的是SQLite Manager,原来也写过一篇相关的文章介绍用法。你可以在站内搜索: SQLite Manager
很郁闷,您站点下载过去的源码运行是没问题的
但自己按照这步骤来制作,导入SQLiteDB.swift就有81个错误,比如:
SQLiteDB.swift:16:19: Use of unresolved identifier 'SQLITE_NULL'
站长回复:你应该是连接头文件没加,或者头文件里面内容有误。再仔细确认下。(见文章2,3步)
你好。针对XCODE 7和IOS9的有吗??
站长回复:SQLiteDB的原作者不更新了。我这边修改了下让它支持Swift2.0,文章和代码已更新。
貌似SQLitDB 里头的asStirng 方法是有问题的吧
站长回复:多谢提醒,原来使用的版本比较老,现在已经更新修正了。