Qt操作SQLite数据库

项目中通常需要采用各种数据库（如 Qracle、SQL Server、MySQL等）来实现对数据的存储、查询等功能。下面讲解如何在 Qt 中操作 SQlite 数据库。

1、SQLite 介绍

Sqlite 数据库作为 Qt 项目开发中经常使用的一个轻量级的数据库，可以说是兼容性相对比较好的数据库之一（Sqlite就像Qt的亲儿子，如同微软兼容Access数据库一样）。Qt5 以上版本可以直接使用（Qt自带驱动），是一个轻量级的数据库，概况起来具有以下优点：

SQLite 的设计目的是嵌入式 SQL 数据库引擎，它基于纯C语言代码，已经应用于非常广泛的领域内。
SQLite 在需要长时间存储时可以直接读取硬盘上的数据文件（.db），在无须长时间存储时也可以将整个数据库置于内存中，两者均不需要额外的服务器端进程，即 SQLite 是无须独立运行的数据库引擎。
源代码开源，你可以用于任何用途，包括出售它。
零配置 – 无需安装和管理配置。
不需要配置，不需要安装，也不需要管理员。
同一个数据文件可以在不同机器上使用，可以在不同字节序的机器间自由共享。
支持多种开发语言，C, C++, PHP, Perl, Java, C#,Python, Ruby等。

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QSS，OpenCV，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓

2、用法

2.1、准备

1、引入SQL模块
在Qt项目文件(.pro文件)中，加入SQL模块：

QT += sql

2、引用头文件

在需要使用SQL的类定义中，引用相关头文件。例如：

#include #include #include

2.2、使用

1、建立数据库

QSqlDatabase database;if (QSqlDatabase::contains("qt_sql_default_connection")){database = QSqlDatabase::database("qt_sql_default_connection");}else{// 建立和SQlite数据库的连接database = QSqlDatabase::addDatabase("QSQLITE");// 设置数据库文件的名字database.setDatabaseName("MyDataBase.db");}

第一行中，建立了一个 QSqlDatabase 对象，后续的操作要使用这个对象。
if 语句用来检查指定的连接（connection）是否存在。这里指定的连接名称（connection name）是qt_sql_default_connection，这是 Qt 默认连接名称。实际使用时，这个名称可以任意取。如果判断此连接已经存在，那么 QSqlDatabase::contains() 函数返回 true。此时，进入第一个分支，QSqlDatabase::database() 返回这个连接。
如果这个连接不存在，则进入else分支，需要创建连接，并添加数据库。在else分支第一行，addDatabase()的参数QSQLITE是SQLite对应的驱动名，不能改。而且需要注意的是，addDatabase()的第二个参数被省略了，第二个参数的默认参数就是上面提到的Qt默认连接名称 qt_sql_default_connection。如果需要使用自定义的连接名称（如果程序需要处理多个数据库文件的话就会这样），则应该加入第二个参数，例如：
database = QSqlDatabase::addDatabase(“QSQLITE”, “my_sql_connection);
这个时候，如果在另一个地方需要判断my_sql_connection连接是否存在，就应该使用 if (QSqlDatabase::contains(“my_sql_connection”))。
else 分支第二行中，setDatabaseName() 的参数是数据库文件名。如果这个数据库不存在，则会在后续操作时自动创建；如果已经存在，则后续的操作会在已有的数据库上进行。

2、打开数据库

使用 open() 打开数据库，并判断是否成功。注意，在第一步检查连接是否存在时，如果连接存在，则在返回这个连接的时候，会默认将数据库打开。

if (!database.open()){qDebug() << "Error: Failed to connect database." << database.lastError();}else{// do something}

如果打开数据库成功，则进入else分支。对数据库的操作都需要在else分支中进行。

3、关闭数据库

数据库操作完成后，最好关闭。

database.close();

4、操作数据库

对数据库进行操作需要用到 QSqlQuery 类，操作前必须定义一个对象。下面举例说明操作方法。操作需要使用 SQL 语句，本文中的几个例子会使用几个常用的语句，关于 SQL 语句的具体信息可以参考我的另一篇博客：[SQL必知必会] 读书笔记。

例1：创建表格

创建一个名为student的表格，表格包含三列，第一列是id，第二列是名字，第三列是年龄。

// 用于执行sql语句的对象QSqlQuery sqlQuery;// 构建创建数据库的sql语句字符串QString createSql = QString("CREATE TABLE student (\id INT PRIMARY KEY NOT NULL,\name TEXT NOT NULL,\age INT NOT NULL)");sqlQuery.prepare(createSql);// 执行sql语句if(!sqlQuery.exec()){qDebug() << "Error: Fail to create table. " << sqlQuery.lastError();}else{ qDebug() << "Table created!";}

第一行定义一个 QSqlQuery 对象。
第二行是一个 QString，其中的内容是 SQLite 语句。对数据库的操作，都是用 SQLite 的语句完成的，把这些指令以 QString 类型，通过 prepare 函数，保存在 QSqlQuery 对象中。也可将指令，以 QString 形式直接写在 exec() 函数的参数中，例如：
sql_query.exec(“CREATE TABLE student (ID INT PRIMARY KEY NOT NULL, …)”);
如果 sql_query.exec() 执行成功，则创建表格成功。

例2：插入单行数据

在刚才创建的表格中，插入单行数据。

// 方法一：使用 bindValue 函数插入单行数据QSqlQuery sqlQuery;sqlQuery.prepare("INSERT INTO student VALUES(:id,:name,:age)");sqlQuery.bindValue(":id", max_id + 1);sqlQuery.bindValue(":name", "Wang");sqlQuery.bindValue(":age", 25);if(!sqlQuery.exec()){qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();}else{// do something}// 方法二：使用 addBindValue 函数插入单行数据QSqlQuery sqlQuery;sqlQuery.prepare("INSERT INTO student VALUES(?, ?, ?)");sqlQuery.addBindValue(max_id + 1);sqlQuery.addBindValue("Wang");sqlQuery.addBindValue(25);if(!sqlQuery.exec()){qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();}else{// do something}// 方法三：直接写出完整语句if(!sql_query.exec("INSERT INTO student VALUES(3, \"Li\", 23)")){qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();}else{// do something }

例3：查询全部数据

QSqlQuery sqlQuery;sqlQuery.exec("SELECT * FROM student");if(!sqlQuery.exec()){qDebug() << "Error: Fail to query table. " << sqlQuery.lastError();}else{while(sqlQuery.next()){int id = sqlQuery.value(0).toInt();QString name = sqlQuery.value(1).toString();int age = sqlQuery.value(2).toInt();qDebug()<<QString("id:%1name:%2age:%3").arg(id).arg(name).arg(age);}}

例4：更新数据（修改数据）

QSqlQuery sqlQuery;sqlQuery.prepare("UPDATE student SET name=?,age=? WHERE id=?");sqlQuery.addBindValue(name);sqlQuery.addBindValue(age);sqlQuery.addBindValue(id);if(!sqlQuery.exec()){qDebug() << sqlQuery.lastError();}else{qDebug() << "updated data success!";}

3、完整示例程序

上面只是列举了几个常用的SQL语句例子，下面贴出一个完整示例程序：

SqliteOperator.h

#ifndef SQLITEOPERATOR_H#define SQLITEOPERATOR_H#include #include #include #include typedef struct{int id;QString name;int age;}w2dba;class SqliteOperator{public:SqliteOperator();// 打开数据库bool openDb(void);// 创建数据表void createTable(void);// 判断数据表是否存在bool isTableExist(QString& tableName);// 查询全部数据void queryTable();// 插入数据void singleInsertData(w2dba &singleData); // 插入单条数据void moreInsertData(QList &moreData); // 插入多条数据// 修改数据void modifyData(int id, QString name, int age);// 删除数据void deleteData(int id);//删除数据表void deleteTable(QString& tableName);// 关闭数据库void closeDb(void);private:QSqlDatabase database;// 用于建立和数据库的连接};#endif //SQLITEOPERATOR_H

SqliteOperator.cpp

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QSS，OpenCV，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓

#include "sqliteoperator.h"// 构造函数中初始化数据库对象，并建立数据库SqliteOperator::SqliteOperator(){if (QSqlDatabase::contains("qt_sql_default_connection")){database = QSqlDatabase::database("qt_sql_default_connection");}else{// 建立和SQlite数据库的连接database = QSqlDatabase::addDatabase("QSQLITE");// 设置数据库文件的名字database.setDatabaseName("MyDataBase.db");}}// 打开数据库bool SqliteOperator::openDb(){if (!database.open()){qDebug() << "Error: Failed to connect database." << database.lastError();}else{// do something}return true;}// 创建数据表void SqliteOperator::createTable(){// 用于执行sql语句的对象QSqlQuery sqlQuery;// 构建创建数据库的sql语句字符串QString createSql = QString("CREATE TABLE student (\id INT PRIMARY KEY NOT NULL,\name TEXT NOT NULL,\age INT NOT NULL)");sqlQuery.prepare(createSql);// 执行sql语句if(!sqlQuery.exec()){qDebug() << "Error: Fail to create table. " << sqlQuery.lastError();}else{qDebug() << "Table created!";}}// 判断数据库中某个数据表是否存在bool SqliteOperator::isTableExist(QString& tableName){QSqlDatabase database = QSqlDatabase::database();if(database.tables().contains(tableName)){return true;}return false;}// 查询全部数据void SqliteOperator::queryTable(){QSqlQuery sqlQuery;sqlQuery.exec("SELECT * FROM student");if(!sqlQuery.exec()){qDebug() << "Error: Fail to query table. " << sqlQuery.lastError();}else{while(sqlQuery.next()){int id = sqlQuery.value(0).toInt();QString name = sqlQuery.value(1).toString();int age = sqlQuery.value(2).toInt();qDebug()<<QString("id:%1name:%2age:%3").arg(id).arg(name).arg(age);}}}// 插入单条数据void SqliteOperator::singleInsertData(w2dba &singledb){QSqlQuery sqlQuery;sqlQuery.prepare("INSERT INTO student VALUES(:id,:name,:age)");sqlQuery.bindValue(":id", singledb.id);sqlQuery.bindValue(":name", singledb.name);sqlQuery.bindValue(":age", singledb.age);if(!sqlQuery.exec()){qDebug() << "Error: Fail to insert data. " << sqlQuery.lastError();}else{// do something}}// 插入多条数据void SqliteOperator::moreInsertData(QList& moredb){// 进行多个数据的插入时，可以利用绑定进行批处理QSqlQuery sqlQuery;sqlQuery.prepare("INSERT INTO student VALUES(?,?,?)");QVariantList idList,nameList,ageList;for(int i=0; i< moredb.size(); i++){idList <<moredb.at(i).id;nameList << moredb.at(i).name;ageList << moredb.at(i).age;}sqlQuery.addBindValue(idList);sqlQuery.addBindValue(nameList);sqlQuery.addBindValue(ageList);if (!sqlQuery.execBatch()) // 进行批处理，如果出错就输出错误{qDebug() << sqlQuery.lastError();}}// 修改数据void SqliteOperator::modifyData(int id, QString name, int age){QSqlQuery sqlQuery;sqlQuery.prepare("UPDATE student SET name=?,age=? WHERE id=?");sqlQuery.addBindValue(name);sqlQuery.addBindValue(age);sqlQuery.addBindValue(id);if(!sqlQuery.exec()){qDebug() << sqlQuery.lastError();}else{qDebug() << "updated data success!";}}// 删除数据void SqliteOperator::deleteData(int id){QSqlQuery sqlQuery;sqlQuery.exec(QString("DELETE FROM student WHERE id = %1").arg(id));if(!sqlQuery.exec()){qDebug()<<sqlQuery.lastError();}else{qDebug()<<"deleted data success!";}}//删除数据表void SqliteOperator::deleteTable(QString& tableName){QSqlQuery sqlQuery;sqlQuery.exec(QString("DROP TABLE %1").arg(tableName));if(sqlQuery.exec()){qDebug() << sqlQuery.lastError();}else{qDebug() << "deleted table success";}}void SqliteOperator::closeDb(void){database.close();}

main.cpp

#include #include "sqliteoperator.h"#include int main(int argc, char *argv[]){QCoreApplication a(argc, argv);//创建并打开SQLite数据库SqliteOperator sqlTest;sqlTest.openDb();// 创建数据表sqlTest.createTable();// 判断数据表是否存在QString str1 = QString("student");qDebug() << "isTabelExist：" <<sqlTest.isTableExist(str1);// 插入单条数据w2dba w2dbaTest1 = {1, "zhangSan", 24};w2dba w2dbaTest2 = {2, "lisi", 28};sqlTest.singleInsertData(w2dbaTest1);sqlTest.singleInsertData(w2dbaTest2);// 插入多条数据QList list;w2dba w2dbaTest3 = {3, "liwu", 26};w2dba w2dbaTest4 = {4, "niuer", 27};list.append(w2dbaTest3);list.append(w2dbaTest4);sqlTest.moreInsertData(list);// 查询全部数据sqlTest.queryTable();qDebug() << endl;// 修改数据sqlTest.modifyData(2, "modify", 10);// 查询全部数据sqlTest.queryTable();qDebug() << endl;// 删除数据sqlTest.deleteData(2);// 查询全部数据sqlTest.queryTable();qDebug() << endl;// 删除数据表QString str2 = QString("student");sqlTest.deleteTable(str2);//关闭数据库sqlTest.closeDb();return a.exec();}

运行结果如下：

Table created!isTabelExist： true"id:1name:zhangSanage:24""id:2name:lisiage:28""id:3name:liwuage:26""id:4name:niuerage:27"updated data success!"id:1name:zhangSanage:24""id:2name:modifyage:10""id:3name:liwuage:26""id:4name:niuerage:27"deleted data success!"id:1name:zhangSanage:24""id:3name:liwuage:26""id:4name:niuerage:27"deleted table success

本文福利，莬费领取Qt开发学习资料包、技术视频，内容包括（C++语言基础，Qt编程入门，QT信号与槽机制，QT界面开发-图像绘制，QT网络，QT数据库编程，QT项目实战，QSS，OpenCV，Quick模块，面试题等等）↓↓↓↓↓↓见下面↓↓文章底部点击莬费领取↓↓

Qt操作SQLite数据库

1、SQLite 介绍

2、用法

2.1、准备

2.2、使用

3、完整示例程序

最新关注

热文推荐

内存操作函数

【已解决cannot import name ‘OrderedDict‘ from ‘typing‘】

实用！7个强大的Python机器学习库！⛵

ElasticSearch使用和架构分析

ArmSoM规划开发基于RK3576的开发套件

ExoPlayer架构详解与源码分析（7）——SampleQueue

Qt操作SQLite数据库

1、SQLite 介绍

2、用法

2.1、准备

2.2、使用

3、完整示例程序

相关文章

最新关注

热文推荐