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]

第一个参数对应驱动名，第二个参数为连接名称 ，如果不使用默认连接名称&ldquo;qt_sql_default_connection&rdquo;的话需要填写该参数。

设置了驱动及连接名称后，就是设置数据库文件的名称/路径，因为SQLite不需要用户名和密码，接下来直接就可以通过open和close函数来打开关闭该数据库了。

此外，如果需要在内存中创建数据库，而不是指定一个文件，可以setDatabaseName(&ldquo;:memory:&rdquo;);

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通过执行&rdquo;BEGIN;&ldquo;或是&rdquo;BEGIN TRANSACTION;&ldquo;开启事务，执行&rdquo;ROLLBACK;&ldquo;进行回滚，执行&rdquo;COMMIT;&ldquo;或是&rdquo;END TRANSACTION;&ldquo;提交事务。QSqlDatabase也提供了对应的transaction、rollback、commit三个函数来执行对应操作。

技巧二：关闭写同步（synchrnous）

在SQLite中，数据库配置的参数都由编译指示（pragma）来实现的，而其中synchronous选项有三种可选状态，分别是full、normal、off。简要说来，full写入速度最慢，但保证数据是安全的，不受断电、系统崩溃等影响，而off可以加速数据库的一些操作，但如果系统崩溃或断电，则数据库可能会损毁。通过执行&rdquo;PRAGMA synchronous = OFF;&ldquo;语句，可以提升效率，不过若不是临时数据库不建议此操作。

SQLite 默认是文件锁， Qt 中 SQLite 默认是以多线程读写模式打开，如果同时写入就会出现写入错误：

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

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

来源：https://blog.csdn.net/m0_60259116/article/details/128226378