当前位置: > > > Swift - 操作SQLite数据库(引用SQLite3库)

Swift - 操作SQLite数据库(引用SQLite3库)

SQLite轻量级数据库在移动应用中使用非常普遍,但是目前的库是C编写的,为了方便使用,对SQLite相关的操作用Swift进行了封装。这个封装代码使用了一个开源项目SQLiteDB,地址是:https://github.com/fahimf/sqlitedb

重要事项(2015-09-25日):SQLiteBD原作者最后只更新到Swift1.2便停止,说后面不会再更新了,如果使用Xcode7便会报错。我这里在其基础上进行了修改,使其支持Swift2.0。
重要事项(2015-11-23日):SQLiteBD原作者又继续更新了,现在已经完美支持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.0):MySQLite2.zip
老代码下载(官方支持Swift2):
MySQLite3.zip 
最新代码下载(Swift3)hangge_645.zip

常见问题汇总:

(1)为什么发布程序运行后,会报数据库不存在错误

具体错误信息:“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” 中把这个数据库添加进来。这样才能将其随同程序一起部署到手机上。

(2)execute()方法执行后的返回值表示什么

execute() 方法可以用来执行任何非查询的 SQL 语句(INSERTDELETEUPDATECREATE 等等),其执行后返回的是一个 CInt 类型的值。
  • 返回 0 表示执行失败
  • 返回非 0 表示执行成功    (一般是1。如果是 INSERT 命令的话返回的是新插入记录的 IDDELETEUPDATE比较特殊,返回的是操作影响的记录数,但如果一条记录都没影响,返回的也是 1。)


(3)如何保存Data数据,比如将图片保存到数据库中?

参考我的另一篇文章:Swift - SQLite中Data类型数据的插入、读取(BLOB类型字段)
评论39
  • 39楼
    2017-08-25 17:47
    dolphinNEUQ

    航哥,您好,到目前为止您可以忽略我前面的提问,非常非常不好意思,因为经过一段时间的试验和读代码,我发现问题的核心是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里面的代码,所以这里就没法解答你的疑问。倒是我要谢谢你反馈了这么多信息,让我更了解里面的机制。

  • 38楼
    2017-08-25 10:35
    dolphinNEUQ

    hangge,您好,刚刚我提到没有测出问题,但是又测了下,发现在重新保存数据的时候会出现问题,报错(ERROR: table persons has no column named passWord)现在想到的方法是加入alter SQL语句来协助修改表的结构,但是那个SQLiteDB中好像没有,感觉需要自己写。。我再研究下他的代码。

  • 37楼
    2017-06-06 12:02
    fcf

    站长的意思是每次用这个库的时候就得先自己手动创建一个data.db添加进去?

    站长回复

    是这样的,SQLiteBD只是一个封装好的数据库操作框架,你要提供数据库给它操作才行。

  • 36楼
    2017-03-21 16:04
    李伟

    我很确定Copy Bundle Resources里面有

    站长回复

    那就奇怪了,我也不知道是什么问题了。

  • 35楼
    2017-03-15 20:22
    菜鸟

    我添加了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添加进来。


  • 34楼
    2017-03-07 13:39
    曾哈哈

    站长,找到了!谢谢你!

    站长回复

    不客气。

  • 33楼
    2017-03-06 16:14
    曾哈哈

    您好,我是自己建的工程,然后建的一个空的data.db放进了工程所在的文件夹里面,可以插入数据之类的而且插入之后的确可以查询得到,但是那个data.db一直都是空的呢什么东西都没有?而且那个工程里面除了这个db文件没有别的bd文件了呀??

    站长回复

    数据保存在App沙盒目录下的data.db文件(程序运行后从工程项目中自动复制过来的,工程里的那个data.db肯定是0字节)

  • 32楼
    2017-03-03 13:42
    单曲循环

    您好,我想请教一下,我要往数据库里存放图片,图片转了data,直接插入数据库了,读出来就是一串字符,不能再被转为图片了,在网上搜不到相关的解决办法,求demo。

    站长回复

    应该是你插入时就不对了,你可看下我的这篇文章,里面有完整的样例。Swift - SQLite中Data类型数据的插入、读取(BLOB类型字段)

  • 31楼
    2017-01-26 00:43
    曾哈哈

    您好,请问一下,发现程序执行的确是成功建表并且可以插入数据,但是在data.db里却看不到任何数据,请问那些数据是到了哪里呀?是在另外的文件里面嘛??

    站长回复

    是在App沙盒目录下的data.db文件。(不是工程里的那个data.db,那个肯定是0字节)

  • 30楼
    2017-01-13 08:57
    Tocat

    写的真好,谢谢分享

    站长回复

    不客气,谢谢你的夸奖。

  • 29楼
    2016-12-14 11:16
    真珠奶茶小土逗

    谢谢站长,问题已解决,之前确实看的是工程里的data.db(手动尴尬)

    站长回复

    不客气,找到原因就好。

  • 28楼
    2016-12-12 11:13
    zhaohuikt@163.com

    话说,删除某一个数据,怎么删?

    站长回复

    删除同样使用execute()方法执行删除语句,比如:
    db.execute(sql: "delete from t_user where uname='hangge'")

  • 27楼
    2016-12-07 23:13
    真珠奶茶小土逗

    站长,我用你的demo运行成功了,但是data.db文件始终是0字节,打开后也什么都没有,不清楚是什么原因

    站长回复

    你确定看的的是App沙盒目录下的data.db文件吗?(不是工程里的那个data.db,那个肯定是0字节)

  • 26楼
    2016-08-23 16:08
    cll12_12

    站长你好,这个在创建表格之前是否要打开数据库?还有就是创建表格返回的CInt类型,等于0就是创建失败,不等0就是创建成功吗?

    站长回复

    1,不管创建表还是进行其他数据库操作,都是先要通过SQLiteDB.sharedInstance获取实例的(其内部已经自动连接打开数据库了) 

     2,0表示执行失败,1表示执行成功。我也在文章末尾更新了相关内容。

  • 25楼
    2016-07-21 15:12
    奈落

    站长好,uname这个列名称怎么改不了,还有如果要把表中的数据调出来传入一个数组应该怎么操作

    站长回复

    (1)你用工具打开data.db就可以改了。

    (2)我代码里let data = db.query("select * from t_user")就是把用户表里的数据都查出,data其实就是一个数组。 你也可以遍历data,将所有数据复制到另一个数组中。

  • 24楼
    2016-07-19 14:59
    liuliu

    data.db是在哪里获取的?

    站长回复

    你可以自己用sqlite工具创建个。

  • 23楼
    2016-06-21 16:48
    jeff

    你好我按照你的步骤自己创建了一个工程 模拟器没有问题但是真机的话就出现了问题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一起部署到手机上。具体可以看我在文章末尾新添加的“常见问题”相关内容。

  • 22楼
    2016-06-09 00:14
    ZST

    请问 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类里面看看。)

  • 21楼
    2016-06-07 16:25
    长颈鹿

    我是长颈鹿,
    经过排查, 是我调用OC中的webservice出现内存泄露,leak里面把泄露点指向了CString。 站长提供的代码是没有问题的

    站长回复

    哦,原来如此。谢谢你的反馈。

  • 20楼
    2016-05-17 14:01
    长颈鹿

    谢谢分享, 请问一下站长
    在SQLiteDB.swift类中, 525行 有如下代码
    let buf = UnsafePointer<Int8>(sqlite3_column_text(stmt, index))
    let val = String.fromCString(buf)
    return val
    我的leak检测工具一直说这里有内存泄露, 请问如何修改

    站长回复

    这里会内存泄漏?还真没注意。看了下也不知道要怎么改,等作者后面更新看会不会修复这个问题吧。

  • 19楼
    2016-05-12 16:45
    admin

    请问下航哥,用什么语句查询数据表中是否存在某个特定的值字段?

    站长回复

    如果是sqlite的话,没有直接获取到列名的办法。不过你可以先获取到数据表的建表语句,再从建表语句中查找字段名(列名)

  • 18楼
    2016-05-09 15:18
    MRWWWW

    您好!我想请问您 这个 //获取数据库实例
    db = SQLiteDB.sharedInstance() 这个实例位置在哪 我想通过其他程序手动去改这个库 可是一直找不到它 谢谢!

    站长回复

    SQLiteDB.swift   这里面有指定默认数据库是:data.db,运行时这个会复制到Documents目录下


    class SQLiteDB {
    let DB_NAME = "data.db"
           .......

  • 17楼
    2016-05-08 16:05
    wang

    楼主 楼主 为什么我添加以后 像var db:SQLiteDB! 这种涉及到SQLITE的都会报错 Use of undeclared type 'SQLiteDB' 我加了桥接头文件 也添加了那三个文件

    站长回复

    我又从新创建个工程试了下,按123流程来是没问题的。所以我也不清楚你那边是什么情况了。

  • 16楼
    2016-05-04 20:57
    xiong

    您好关于 data.db文件创建的时候sqlitemanager里只找到 .sqlite文件,.db的是在sqlitemanager的什么位置创建啊?望站长不吝赐教

    站长回复

    这个是同一个东西,你把 文件后缀从.sqlite改成.db试试看,应该是可以用的。

  • 15楼
    2016-05-02 02:13
    小黄

    楼主真是不错 学习了

    站长回复

    谢谢你的支持和鼓励,欢迎常来。

  • 14楼
    2016-02-19 10:05
    hard-working1

    lz, 针对此处的demo那个data.db除了拷贝你的data.db或者用数据库工具创建,还有其他方法吗? 实际项目中那个data.db是怎么来的?

    站长回复

    实际开发中也是先使用工具创建好数据库,然后放到应用中使用。(数据库中的表一般也是使用工具提前建好的)

  • 13楼
    2016-01-28 14:33
    董诗磊

    为甚么没有增上改查请站长帮助

    站长回复

    SQLite的增删改查用的就是标准的sql语句,同其它的数据库区别不大。文章里其实有insert,select样例了,update、delete就不再写了。网上搜一下就能找到很多。毕竟本文主要介绍Swfit如何操作SQLite,而不是sql语言教程。

  • 12楼
    2016-01-22 17:28
    MAR

    "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"]!
    }

  • 11楼
    2016-01-21 11:16
    我不是张三

    请问这个要实现自增列怎么实现.

    站长回复

    建表的时候把这个字段设为integer primary key即可。(样例里的uid就是自增主键,每次插入数据它会自动+1)

  • 10楼
    2016-01-13 19:08
    jelly

    多条件查询怎么写总是报错

    站长回复

    我随便测试了下多条件查询也是没问题的啊。
    let data = db.query("select * from t_user where uname = '123' and mobile = 'ttt555' ")

  • 9楼
    2015-12-24 09:24
    oneByOne

    你好、我使用的时候出现SQLiteDB - failed to copy writable version of DB!
    Error - 未能打开文件“data.db”,因为它不存在。 我看你的工程里是有这个data.db文件没看到代码在哪创建的、我拷过去也是不行、请问我该怎么创建这个data.db

    站长回复

    这个db文件是我使用SQLite Manager来创建的,这是一个很好用的SQLite管理工具,你可以下载个试试。
    如果直接用我工程里的data.db应该也没问题的,你打开项目文件夹跟我的样例比较下,看下是不是路径问题。

  • 8楼
    2015-12-18 19:27
    尼美的夏天

    db.execute(sql) 这样执行sql之后就把数据插入数据库了么? 为什么我没有插入数据库呢 别的都没问题了。

    站长回复

    db.execute(sql)执行后就可以了。不太确定你是什么原因,执行插入语句有报错吗,插入完执行查询语句也是空的吗。

  • 7楼
    2015-11-24 22:39
    爱不到要偷

    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,不好意思啊。

  • 6楼
    2015-11-16 11:52

    版主謝謝分享
    ^^

    站长回复

    不客气,欢迎常来看看

  • 5楼
    2015-10-13 11:18
    xi

    想使用现有数据库,如何配置data.db路径?

    站长回复

    SQLiteDB的init()方法可以带Group ID,通过开启App Groups可以实现扩展(Extension)和容器应用(Containing App)之间的数据共享

  • 4楼
    2015-09-25 22:31
    57223165@qq.com

    还有个问题,data.db是怎么新建的呢?

    站长回复

    这个可以自己找个sqlite工具创建。我用的是SQLite Manager,原来也写过一篇相关的文章介绍用法。你可以在站内搜索: SQLite Manager

  • 3楼
    2015-09-25 22:29
    smanor

    很郁闷,您站点下载过去的源码运行是没问题的
    但自己按照这步骤来制作,导入SQLiteDB.swift就有81个错误,比如:
    SQLiteDB.swift:16:19: Use of unresolved identifier 'SQLITE_NULL'

    站长回复

    你应该是连接头文件没加,或者头文件里面内容有误。再仔细确认下。(见文章2,3步)

  • 2楼
    2015-09-24 17:18
    奶嘴

    你好。针对XCODE 7和IOS9的有吗??

    站长回复

    SQLiteDB的原作者不更新了。我这边修改了下让它支持Swift2.0,文章和代码已更新。

  • 1楼
    2015-06-08 17:41
    manbumanman

    貌似SQLitDB 里头的asStirng 方法是有问题的吧

    站长回复

    多谢提醒,原来使用的版本比较老,现在已经更新修正了。