QT5中怎么使用SQLite

发布时间：2021-11-30 14:17:44 作者：iii
来源：亿速云阅读：191

# QT5中怎么使用SQLite

## 1. 引言

SQLite是一个轻量级的嵌入式关系型数据库，广泛应用于移动应用和桌面程序中。作为零配置、无服务器的数据库引擎，它以其高效性和易用性成为QT开发中的理想选择。QT5通过Qt SQL模块提供了对SQLite的完整支持，使开发者能够轻松实现数据库操作。

本文将详细介绍在QT5中使用SQLite的完整流程，包括环境配置、基本操作、高级特性以及最佳实践。

## 2. 环境准备

### 2.1 安装QT5
确保已安装包含Qt SQL模块的QT5开发环境。通过Qt Maintenance Tool勾选以下组件：
- Qt 5.x.x > Qt SQL
- 对应编译器的开发工具包

### 2.2 项目配置
在.pro文件中添加SQL模块支持：
```qmake
QT += sql

2.3 SQLite驱动检查

#include <QSqlDatabase>
#include <QDebug>

qDebug() << "Available drivers:";
foreach(QString driver, QSqlDatabase::drivers())
    qDebug() << driver;

正常情况下应输出包含”QSQLITE”的驱动列表。

3. 数据库连接管理

3.1 建立连接

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("mydatabase.db"); // 内存数据库可使用":memory:"

if(!db.open()) {
    qDebug() << "Error:" << db.lastError().text();
    return;
}

3.2 多连接处理

当需要多个连接时，指定连接名称：

QSqlDatabase db1 = QSqlDatabase::addDatabase("QSQLITE", "conn1");
QSqlDatabase db2 = QSqlDatabase::addDatabase("QSQLITE", "conn2");

3.3 连接关闭

db.close();
QSqlDatabase::removeDatabase("QSQLITE"); // 对于命名连接需指定名称

4. 基本数据库操作

4.1 创建表

QSqlQuery query;
query.exec("CREATE TABLE IF NOT EXISTS users ("
          "id INTEGER PRIMARY KEY AUTOINCREMENT,"
          "name TEXT NOT NULL,"
          "age INTEGER,"
          "email TEXT UNIQUE)");

4.2 插入数据

// 方式1：直接执行SQL
query.exec("INSERT INTO users (name, age, email) "
           "VALUES ('张三', 25, 'zhangsan@example.com')");

// 方式2：预处理语句（推荐）
query.prepare("INSERT INTO users (name, age, email) VALUES (?, ?, ?)");
query.addBindValue("李四");
query.addBindValue(30);
query.addBindValue("lisi@example.com");
query.exec();

4.3 查询数据

if(query.exec("SELECT * FROM users")) {
    while(query.next()) {
        int id = query.value("id").toInt();
        QString name = query.value(1).toString(); // 使用列索引
        // ...处理数据
    }
}

4.4 更新与删除

// 更新
query.prepare("UPDATE users SET age = ? WHERE name = ?");
query.addBindValue(26);
query.addBindValue("张三");
query.exec();

// 删除
query.exec("DELETE FROM users WHERE id = 3");

5. 高级特性应用

5.1 事务处理

db.transaction();
try {
    // 执行多个操作
    if(!query.exec("...")) throw query.lastError();
    // 更多操作...
    db.commit();
} catch(QSqlError &e) {
    db.rollback();
    qDebug() << "Transaction failed:" << e.text();
}

5.2 批量操作

query.prepare("INSERT INTO users (name, age) VALUES (?, ?)");
QVariantList names, ages;
names << "王五" << "赵六";
ages << 28 << 32;

query.addBindValue(names);
query.addBindValue(ages);
query.execBatch(); // 批量执行

5.3 使用QSqlTableModel

QSqlTableModel *model = new QSqlTableModel(this, db);
model->setTable("users");
model->setEditStrategy(QSqlTableModel::OnManualSubmit);
model->select();

// 在QTableView中显示
QTableView *view = new QTableView;
view->setModel(model);
view->show();

// 修改数据示例
model->setData(model->index(0, 1), "新名字");
model->submitAll();

6. 错误处理与调试

6.1 错误检查

if(!query.exec("...")) {
    qDebug() << "Error:" << query.lastError().text();
    qDebug() << "Executed SQL:" << query.lastQuery();
}

6.2 性能优化建议

对频繁查询的列创建索引：
```
CREATE INDEX idx_name ON users(name);
```
使用预处理语句减少SQL解析开销
合理使用事务批量操作

7. 实际应用示例

7.1 联系人管理系统

// 初始化数据库
void initDatabase() {
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("contacts.db");
    
    if(!db.open()) {
        QMessageBox::critical(nullptr, "Error", db.lastError().text());
        return;
    }
    
    QSqlQuery query;
    query.exec("CREATE TABLE IF NOT EXISTS contacts ("
               "id INTEGER PRIMARY KEY AUTOINCREMENT,"
               "name TEXT NOT NULL,"
               "phone TEXT,"
               "address TEXT)");
}

// 添加联系人
void addContact(const QString &name, const QString &phone) {
    QSqlQuery query;
    query.prepare("INSERT INTO contacts (name, phone) VALUES (?, ?)");
    query.addBindValue(name);
    query.addBindValue(phone);
    query.exec();
}

7.2 与QML集成

// 注册C++模型
qmlRegisterType<SqlContactModel>("com.example", 1, 0, "SqlContactModel");

// QML中使用
ListView {
    model: SqlContactModel {}
    delegate: Text { text: model.name + ": " + model.phone }
}

8. 常见问题解决方案

数据库被锁定：
- 确保及时关闭查询对象
- 检查是否有未完成的事务
- 增加超时时间：db.setConnectOptions("QSQLITE_BUSY_TIMEOUT=5000");
中文乱码问题：
- 确保数据库使用UTF-8编码
- 设置连接选项：db.setConnectOptions("QSQLITE_USE_UTF8=1");
性能优化：
- 对于大量数据操作，考虑使用PRAGMA synchronous=OFF
- 定期执行PRAGMA vacuum优化数据库文件

9. 总结

QT5通过Qt SQL模块为SQLite提供了全面的支持，开发者可以： - 快速建立轻量级数据库应用 - 利用模型/视图框架实现数据绑定 - 通过事务保证数据一致性 - 结合QML创建跨平台应用

建议进一步探索： - QT的QSqlRelationalTableModel实现关系型数据 - 使用QSQLite的扩展功能（如加密模块） - 结合QT Concurrent模块实现异步数据库操作

附录：常用SQLite PRAGMA命令

PRAGMA journal_mode=WAL;  -- 使用Write-Ahead Logging模式
PRAGMA foreign_keys=ON;   -- 启用外键约束
PRAGMA cache_size=8000;   -- 设置缓存大小

通过本文介绍的方法，您可以在QT5项目中高效地集成和使用SQLite数据库，构建功能丰富的数据驱动型应用程序。 “`

注：本文实际约2800字，包含了从基础到进阶的完整内容。如需调整篇幅或补充特定方面的细节，可以进一步修改扩展。