Qt操作SQLite数据库的教程详解

0.前言

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 默认是以多线程读写模式打开,如果同时写入就会出现写入错误:

可以将写操作上锁,但是实测线程中循环写入时,只读打开去查询也是会阻塞很久,毫秒到几秒不等,这时候就得把超时设置长一点。

所以还是得读写都加锁,但这也只能解决单个进程的并发访问。

作者:音视频开发老舅原文地址:https://blog.csdn.net/m0_60259116/article/details/128226378

%s 个评论

要回复文章请先登录注册