Qt 中利用 SQLite 数据库的完整指南

科技颠覆者  金牌会员 | 2025-3-10 20:20:01 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题
楼主

主题 988|帖子 988|积分 2964

SQLite 是一款轻量级、嵌入式的关系型数据库，无需独立的服务器进程，数据以文件形式存储，非常适合桌面和移动端应用的本地数据管理。Qt 通过 Qt SQL 模块提供了对 SQLite 的原生支持，开发者可以轻松实现数据库的增删改查、事务处置惩罚等操作。本文将具体先容如安在 Qt 中集成并利用 SQLite 数据库。
1. 环境配置与准备工作

1.1 启用 Qt SQL 模块

在 Qt 项目文件（.pro）中添加 SQL 模块依赖：
   QT += sql
  1.2 包罗头文件

在代码中引入必要的类：
   #include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>
#include <QSqlTableModel>
  
2. 连接 SQLite 数据库

2.1 创建并打开数据库

  1. QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
  2. db.setDatabaseName("my_database.db"); // 数据库文件名（或完整路径）
  4. if (!db.open()) {
  5.     qDebug() << "Error: Failed to open database:" << db.lastError().text();
  6.     return;
  7. }
复制代码


  • 阐明：

    • QSQLITE 是 Qt 内置的 SQLite 驱动名称。
    • 假如文件不存在，SQLite 会主动创建新数据库。

2.2 关闭数据库

   db.close(); // 显式关闭连接（通常不需要，程序退出时主动关闭）
  
3. 实行 SQL 操作

3.1 创建表

  1. QSqlQuery query;
  2. query.exec("CREATE TABLE IF NOT EXISTS users ("
  3.           "id INTEGER PRIMARY KEY AUTOINCREMENT,"
  4.           "name TEXT NOT NULL,"
  5.           "age INTEGER,"
  6.           "email TEXT UNIQUE)");
复制代码
3.2 插入数据

直接实行 SQL

  1. query.exec("INSERT INTO users (name, age, email) VALUES ('Alice', 30, 'alice@example.com')");
复制代码
利用预处置惩罚语句（防 SQL 注入）

  1. query.prepare("INSERT INTO users (name, age, email) VALUES (?, ?, ?)");
  2. query.addBindValue("Bob");
  3. query.addBindValue(25);
  4. query.addBindValue("bob@example.com");
  5. query.exec();
复制代码
3.3 查询数据

  1. if (query.exec("SELECT id, name, age FROM users WHERE age > 20")) {
  2.     while (query.next()) {
  3.         int id = query.value(0).toInt();
  4.         QString name = query.value("name").toString();
  5.         int age = query.value(2).toInt();
  6.         qDebug() << "User:" << id << name << age;
  7.     }
  8. } else {
  9.     qDebug() << "Query error:" << query.lastError().text();
  10. }
复制代码
3.4 更新与删除数据

  1. // 更新
  2. query.exec("UPDATE users SET age = 31 WHERE name = 'Alice'");
  4. // 删除
  5. query.exec("DELETE FROM users WHERE email IS NULL");
复制代码
4. 事务处置惩罚

通过事务确保多个操作的原子性：
  1. db.transaction(); // 开始事务
  3. QSqlQuery query;
  4. query.exec("UPDATE account SET balance = balance - 100 WHERE id = 1");
  5. query.exec("UPDATE account SET balance = balance + 100 WHERE id = 2");
  7. if (/* 检查操作是否成功 */) {
  8.     db.commit();   // 提交事务
  9. } else {
  10.     db.rollback(); // 回滚事务
  11. }
复制代码
5. 利用模型-视图（Model-View）编程

Qt 提供了 QSqlTableModel 和 QSqlQueryModel，方便将数据库与 UI 组件（如 QTableView）绑定。
5.1 显示表格数据

  1. QSqlTableModel *model = new QSqlTableModel(this);
  2. model->setTable("users");
  3. model->setFilter("age > 20");
  4. model->select();
  6. QTableView *view = new QTableView;
  7. view->setModel(model);
  8. view->show();
复制代码
5.2 编辑并生存修改

  1. model->setEditStrategy(QSqlTableModel::OnManualSubmit);
  2. // 用户通过视图修改数据后调用：
  3. model->submitAll(); // 提交所有更改到数据库
复制代码
6. 错误处置惩罚与调试

6.1 捕捉数据库错误

  1. if (!query.exec("INVALID SQL")) {
  2.     qDebug() << "SQL Error:" << query.lastError().text();
  3.     qDebug() << "Executed SQL:" << query.lastQuery();
  4. }
复制代码
6.2 查看支持的数据库驱动

  1. qDebug() << "Available drivers:" << QSqlDatabase::drivers();
  2. // 输出示例：("QSQLITE", "QMYSQL", "QPSQL")
复制代码
7. 高级本事与注意事项

7.1 批量插入优化

利用事务加速大批量插入：
  1. db.transaction();
  2. QSqlQuery query;
  3. query.prepare("INSERT INTO users (name) VALUES (?)");
  4. for (const QString &name : namesList) {
  5.     query.addBindValue(name);
  6.     query.exec();
  7. }
  8. db.commit();
复制代码
7.2 多线程访问



  • SQLite 默认不支持多线程同时写入，需通过 QSqlDatabase::cloneDatabase 为每个线程创建独立连接。
  • 在子线程中利用数据库时，确保在子线程内打开连接。
7.3 数据库迁移



  • 利用 user_version 字段管理数据库版本：
    1. query.exec("PRAGMA user_version = 1"); // 设置版本号
    2. query.exec("PRAGMA user_version");     // 读取版本号
    复制代码
8. 常见问题解答

Q1：数据库文件被锁定了怎么办？



  • 确保所有 QSqlQuery 和 QSqlDatabase 对象在利用后及时释放。
  • 避免多线程同时写入同一连接。
Q2：怎样防止 SQL 注入？



  • 始终利用 prepare() 和 addBindValue() 替代字符串拼接。
Q3：查询性能慢怎样优化？



  • 为常用查询字段添加索引。
  • 镌汰频繁的小事务，合并为批量操作。
9. 完整示例代码

  1. #include <QCoreApplication>
  2. #include <QSqlDatabase>
  3. #include <QSqlQuery>
  4. #include <QDebug>
  6. int main(int argc, char *argv[]) {
  7.     QCoreApplication a(argc, argv);
  9.     QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
  10.     db.setDatabaseName("test.db");
  11.    
  12.     if (!db.open()) {
  13.         qDebug() << "Database error:" << db.lastError().text();
  14.         return -1;
  15.     }
  17.     QSqlQuery query;
  18.     query.exec("CREATE TABLE IF NOT EXISTS books ("
  19.                "id INTEGER PRIMARY KEY,"
  20.                "title TEXT,"
  21.                "author TEXT)");
  23.     query.prepare("INSERT INTO books (title, author) VALUES (?, ?)");
  24.     query.addBindValue("Qt Programming");
  25.     query.addBindValue("John Doe");
  26.     query.exec();
  28.     query.exec("SELECT * FROM books");
  29.     while (query.next()) {
  30.         qDebug() << "Book:" << query.value("title").toString()
  31.                  << "by" << query.value("author").toString();
  32.     }
  34.     db.close();
  35.     return a.exec();
  36. }
复制代码
10. 总结

Qt 的 SQLite 支持使得本地数据管理变得简朴高效。焦点要点包括：


  • 利用 QSqlDatabase 管理数据库连接。
  • 通过 QSqlQuery 实行 SQL 语句并处置惩罚结果。
  • 利用事务保证数据划一性。
  • 结合模型-视图框架快速构建 UI 界面。
官方文档参考：


  • Qt SQL Module
  • SQLite 官方文档

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览
返回列表

快速回复

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

科技颠覆者

金牌会员
这个人很懒什么都没写!

楼主热帖

标签云

运维 CIO 存储 服务器
微信订阅号
微信服务号
微信客服
小程序
H5
关于我们 商务合作 网站地图
©Copyright 2022-2024 杭州祥升科技有限公司 版权所有 浙ICP备20004199号
快速回复 返回顶部 返回列表