Qt操作SQLite数据库的教程详解
音视频开发老舅 人气:00.前言
SQLite是一款开源、轻量级、跨平台的数据库,无需server,无需安装和管理配置。它的设计目标是嵌入式的,所以很适合小型应用,也是Qt应用开发种常用的一种数据库。
1.驱动
Qt SQL模块使用驱动程序插件(plugins)与不同的数据库API进行通信。由于Qt的SQL模块API与数据库无关,因此所有特定于数据库的代码都包含在这些驱动程序中。Qt提供了几个驱动程序,也可以添加其他驱动程序。提供驱动程序源代码,可用作编写自己的驱动程序的模型。
QtCreator在*.pro中引入sql模块(QT+=sql),或是VS中在Qt VS Tool里勾选上sql模块,就可以使用该模块的接口了。
可以使用QSqlDatabase::drivers()获取驱动程序列表并打印,Qt5.9.7输出如下:
其中,SQLite是一个进程内数据库,这意味着没有必要拥有数据库服务器。SQLite在单个文件上运行,在打开连接时必须将其设置为数据库名称。如果该文件不存在,SQLite将尝试创建它。。
2.初相遇
/* * ... ... * 我喜欢那样的梦 * 在梦里 一切都可以重新开始 * 一切都可以慢慢解释 * 心里甚至还能感觉到所有被浪费的时光 * 竟然都能重回时的狂喜和感激 * ... ... * * ----席慕容《初相遇》 */ #include <QSqlDatabase> #include <QDebug> void initDb() { //qDebug()<<QSqlDatabase::drivers();//打印驱动列表 QSqlDatabase db; //检测已连接的方式 - 默认连接名 //QSqlDatabase::contains(QSqlDatabase::defaultConnection) if(QSqlDatabase::contains("qt_sql_default_connection")) db = QSqlDatabase::database("qt_sql_default_connection"); else db = QSqlDatabase::addDatabase("QSQLITE"); //检测已连接的方式 - 自定义连接名 /*if(QSqlDatabase::contains("mysql_connection")) db = QSqlDatabase::database("mysql_connection"); else db = QSqlDatabase::addDatabase("QSQLITE","mysql_connection");*/ //设置数据库路径,不存在则创建 db.setDatabaseName("sqltest.db"); //db.setUserName("gongjianbo"); //SQLite不需要用户名和密码 //db.setPassword("qq654344883"); //打开数据库 if(db.open()){ qDebug()<<"open success"; //关闭数据库 db.close(); } }
上面的代码中,先是创建了一个QSqlDatabase对象,该类用于处理数据库的连接。contains方法用于查看给定的连接名称是否在连接列表中,database方法获取数据库连接,前提是已使用addDatabase添加数据库连接。addDatabase声明如下:
QSqlDatabase QSqlDatabase::addDatabase(const QString &type, const QString &connectionName = QLatin1String(defaultConnection)) [static]
第一个参数对应驱动名,第二个参数为连接名称 ,如果不使用默认连接名称“qt_sql_default_connection”的话需要填写该参数。
设置了驱动及连接名称后,就是设置数据库文件的名称/路径,因为SQLite不需要用户名和密码,接下来直接就可以通过open和close函数来打开关闭该数据库了。
此外,如果需要在内存中创建数据库,而不是指定一个文件,可以setDatabaseName(“:memory:”);
db.setDatabaseName(":memory:");
3.创建表
SQL语句执行需要用到QSqlQuery类,文档有云:
QSqlQuery封装了在QSqlDatabase上执行的SQL查询中创建,导航和检索数据所涉及的功能。它可以被用来执行DML(数据操纵语言)语句,例如select、insert、update、delete,以及DDL(数据定义语言)语句,如create table,还可以用于执行非标准SQL的特定于数据库的命令。
成功执行的SQL语句将查询的状态设置为活动状态,以便isActive()返回true。否则,查询的状态将设置为非活动状态。在任何一种情况下,执行新的SQL语句时,查询都位于无效记录上。必须先将活动查询导航到有效记录(以便isActive()返回true),然后才能检索值。
#include <QSqlDatabase> #include <QSqlError> #include <QSqlQuery> void createTable() { //sql语句不熟悉的推荐《sql必知必会》,轻松入门 //如果不存在则创建my_table表 //id自增,name唯一 const QString sql=R"( CREATE TABLE IF NOT EXISTS my_table ( id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, name CHAR (50) UNIQUE NOT NULL, age INTEGER );)"; //QSqlQuery构造前,需要db已打开并连接 //未指定db或者db无效时使用默认连接进行操作 QSqlQuery query; if(query.exec(sql)){ qDebug()<<"init table success"; }else{ //打印sql语句错误信息 qDebug()<<"init table error"<<query.lastError(); } }
代码通过QSqlQuery的exec方法执行SQL语句,创建了一个简单的数据表。exec执行SQL语句成功返回true,否则返回false。
QSqlQuery的构造函数可以指定QDatabase参数,如果未指定db,或者db无效将使用默认连接。
QSqlQuery::QSqlQuery(QSqlDatabase db);
要注意的是,对于SQLite,exec方法一次只能执行一个语句。
4.执行增删改查
执行了上面的操作且数据库已open,就能使用QSqlQuery的exec方法来完成增删改查了。
//插入数据 void insertRecord(const QString &name, int age) { QSqlQuery query; //方式一,直接执行SQL语句 query.exec(QString(R"(INSERT INTO my_table(name,age) VALUES('%1',%2);)") .arg(name).arg(age)); //方式二,绑定值,待定变量默认用问号占位,注意字符串也没有引号 /*query.prepare(R"(INSERT INTO my_table(name,age) VALUES(?,?);)"); query.addBindValue(name); query.addBindValue(age); query.exec();*/ } //删除数据 void deleteRecord(const QString &name) { QSqlQuery query; //方式一,直接执行SQL语句 query.exec(QString(R"(DELETE FROM my_table WHERE name='%1';)") .arg(name)); //方式二,绑定值,待定变量默认用问号占位 /*query.prepare(R"(DELETE FROM my_table WHERE name=?;)"); query.addBindValue(name); query.exec();*/ } //更新数据 void updateRecord(const QString &name, int age) { QSqlQuery query; //方式一,直接执行SQL语句 query.exec(QString(R"(UPDATE my_table SET age=%2 WHERE name='%1';)") .arg(name).arg(age)); //方式二,绑定值,待定变量默认问号,可自定义 /*query.prepare(R"(UPDATE my_table SET age=:age WHERE name=:name;)"); query.bindValue(":name",name);//通过自定义的别名来替代 query.bindValue(":age",age); query.exec();*/ } //查询数据 int searchRecord(const QString &name) { QSqlQuery query; query.exec(QString(R"(SELECT age FROM my_table WHERE name='%1';)") .arg(name)); //获取查询结果的第0个值, //如果结果是多行数据,可用while(query.next()){}遍历每一行 int ageValue=-1; if(query.next()){ ageValue=query.value(0).toInt(); } qDebug()<<ageValue; return ageValue; }
可以看到,如果熟悉SQL语句的话,很容易就实现了增删改查功能。
对于 BLOB 类型,查询后可以 toByteArray,修改时可以 bindValue QByteArray。
5.进阶
有时候会遇到大量数据操作的情况,这时候用普通的insert之类的语句循环操作可能会很慢。
技巧一:开启事务
SQLite通过执行”BEGIN;“或是”BEGIN TRANSACTION;“开启事务,执行”ROLLBACK;“进行回滚,执行”COMMIT;“或是”END TRANSACTION;“提交事务。QSqlDatabase也提供了对应的transaction、rollback、commit三个函数来执行对应操作。
技巧二:关闭写同步(synchrnous)
在SQLite中,数据库配置的参数都由编译指示(pragma)来实现的,而其中synchronous选项有三种可选状态,分别是full、normal、off。简要说来,full写入速度最慢,但保证数据是安全的,不受断电、系统崩溃等影响,而off可以加速数据库的一些操作,但如果系统崩溃或断电,则数据库可能会损毁。通过执行”PRAGMA synchronous = OFF;“语句,可以提升效率,不过若不是临时数据库不建议此操作。
SQLite 默认是文件锁, Qt 中 SQLite 默认是以多线程读写模式打开,如果同时写入就会出现写入错误:
可以将写操作上锁,但是实测线程中循环写入时,只读打开去查询也是会阻塞很久,毫秒到几秒不等,这时候就得把超时设置长一点。
所以还是得读写都加锁,但这也只能解决单个进程的并发访问。
加载全部内容