Qt使用 SQLite 数据库的基本方法

小刘同学++2025-04-26 2:07

在 Qt 中，使用 SQLite 数据库的基本方法与 MySQL 类似，但 SQLite 是一个轻量级的嵌入式数据库，通常不需要外部数据库服务器。你可以直接在本地磁盘上操作 SQLite 数据库文件。

1. 安装 SQLite 驱动

通常，Qt 默认包含了对 SQLite 的支持，所以不需要额外安装 SQLite 驱动。您可以通过 QSqlDatabase 类来直接操作 SQLite 数据库。

2. 连接到 SQLite 数据库

连接到 SQLite 数据库通常只需要指定数据库文件路径。SQLite 是一个文件级数据库，所以你需要提供文件路径来连接该数据库。如果该文件不存在，SQLite 会自动创建一个新的数据库文件。

cpp 复制代码 
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>

bool connectToDatabase() {
    // 创建 SQLite 数据库连接
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");  // 使用 SQLite 驱动

    // 设置数据库文件路径
    db.setDatabaseName("test.db");  // 数据库文件名，可以是相对路径或者绝对路径

    // 打开数据库
    if (!db.open()) {
        qDebug() << "Failed to connect to the database!";
        return false;
    } else {
        qDebug() << "Successfully connected to the database!";
        return true;
    }
}

3. 执行 SQL 查询

与 MySQL 操作相似，SQLite 的操作也可以通过 QSqlQuery 类来进行。以下是常见的 SQL 操作：SELECT、INSERT、UPDATE 和 DELETE。

3.1. 查询数据 (SELECT)

cpp 复制代码 
void queryData() {
    QSqlQuery query;

    // 执行 SELECT 查询
    if (query.exec("SELECT * FROM employees")) {
        // 遍历查询结果
        while (query.next()) {
            QString name = query.value(0).toString(); // 获取第一列数据
            int age = query.value(1).toInt();         // 获取第二列数据
            qDebug() << "Employee name:" << name << ", Age:" << age;
        }
    } else {
        qDebug() << "Query failed:" << query.lastError();
    }
}

3.2. 插入数据 (INSERT)

cpp 复制代码 
void insertData() {
    QSqlQuery query;

    // 执行 INSERT 语句
    query.prepare("INSERT INTO employees (name, age) VALUES (:name, :age)");
    query.bindValue(":name", "John Doe");
    query.bindValue(":age", 30);

    if (query.exec()) {
        qDebug() << "Data inserted successfully!";
    } else {
        qDebug() << "Insert failed:" << query.lastError();
    }
}

3.3. 更新数据 (UPDATE)

cpp 复制代码 
void updateData() {
    QSqlQuery query;

    // 执行 UPDATE 语句
    query.prepare("UPDATE employees SET age = :age WHERE name = :name");
    query.bindValue(":age", 35);
    query.bindValue(":name", "John Doe");

    if (query.exec()) {
        qDebug() << "Data updated successfully!";
    } else {
        qDebug() << "Update failed:" << query.lastError();
    }
}

3.4. 删除数据 (DELETE)

cpp 复制代码 
void deleteData() {
    QSqlQuery query;

    // 执行 DELETE 语句
    query.prepare("DELETE FROM employees WHERE name = :name");
    query.bindValue(":name", "John Doe");

    if (query.exec()) {
        qDebug() << "Data deleted successfully!";
    } else {
        qDebug() << "Delete failed:" << query.lastError();
    }
}

4. 创建表格

如果您需要创建一个表格，可以使用 CREATE TABLE SQL 语句：

cpp 复制代码 
void createTable() {
    QSqlQuery query;

    // 执行 CREATE TABLE 语句
    QString createQuery = "CREATE TABLE IF NOT EXISTS employees ("
                          "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                          "name TEXT, "
                          "age INTEGER)";
    if (query.exec(createQuery)) {
        qDebug() << "Table created successfully!";
    } else {
        qDebug() << "Table creation failed:" << query.lastError();
    }
}

5. 事务处理

事务可以确保多条 SQL 操作要么全部成功，要么全部失败。SQLite 支持事务操作：

cpp 复制代码 
void transactionExample() {
    QSqlQuery query;
    
    // 开始事务
    QSqlDatabase::database().transaction();

    // 执行多条 SQL 语句
    query.exec("UPDATE employees SET age = 25 WHERE name = 'Alice'");
    query.exec("INSERT INTO employees (name, age) VALUES ('Bob', 30)");

    // 提交事务
    if (query.isActive()) {
        QSqlDatabase::database().commit();
        qDebug() << "Transaction committed successfully!";
    } else {
        QSqlDatabase::database().rollback();
        qDebug() << "Transaction rolled back!";
    }
}

6. 处理查询结果

在查询数据时，您可以通过 QSqlQuery 对象的 next() 方法来遍历结果集，并使用 value() 方法来获取每一列的数据。您可以根据列的索引或列名来获取数据。

cpp 复制代码 
QSqlQuery query;
query.exec("SELECT id, name FROM employees");

while (query.next()) {
    int id = query.value("id").toInt();       // 使用列名获取数据
    QString name = query.value(1).toString();  // 使用列索引获取数据
    qDebug() << "Employee ID:" << id << ", Name:" << name;
}

7. 关闭数据库连接

当您完成数据库操作后，记得关闭连接：

cpp 复制代码 
QSqlDatabase::database().close();

8. 完整示例代码

cpp 复制代码 
#include <QCoreApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>

bool connectToDatabase() {
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("test.db");

    if (!db.open()) {
        qDebug() << "Failed to connect to the database!";
        return false;
    }
    return true;
}

void createTable() {
    QSqlQuery query;
    QString createQuery = "CREATE TABLE IF NOT EXISTS employees ("
                          "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                          "name TEXT, "
                          "age INTEGER)";
    if (query.exec(createQuery)) {
        qDebug() << "Table created successfully!";
    } else {
        qDebug() << "Table creation failed:" << query.lastError();
    }
}

void insertData() {
    QSqlQuery query;
    query.prepare("INSERT INTO employees (name, age) VALUES (:name, :age)");
    query.bindValue(":name", "Alice");
    query.bindValue(":age", 28);

    if (query.exec()) {
        qDebug() << "Data inserted successfully!";
    } else {
        qDebug() << "Insert failed:" << query.lastError();
    }
}

void queryData() {
    QSqlQuery query;

    if (query.exec("SELECT * FROM employees")) {
        while (query.next()) {
            QString name = query.value(1).toString();
            int age = query.value(2).toInt();
            qDebug() << "Employee name:" << name << ", Age:" << age;
        }
    } else {
        qDebug() << "Query failed:" << query.lastError();
    }
}

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    if (connectToDatabase()) {
        createTable();
        insertData();
        queryData();
    }

    return a.exec();
}

总结

  • QSqlDatabase 用于连接数据库，addDatabase() 设置数据库驱动。
  • QSqlQuery 用于执行 SQL 查询和命令，可以绑定参数和获取查询结果。
  • SQLite 是一个文件级数据库，可以直接操作本地文件，无需额外的数据库服务器。
  • 使用 事务 可以确保多个 SQL 操作的原子性。
相关推荐
jiayou642 小时前
KingbaseES 实战：审计追踪配置与运维实践
数据库
NineData14 小时前
NineData 迁移评估功能正式上线
数据库·dba
NineData20 小时前
数据库迁移总踩坑？用 NineData 迁移评估，提前识别所有兼容性风险
数据库·程序员·云计算
赵渝强老师1 天前
【赵渝强老师】PostgreSQL中表的碎片
数据库·postgresql
blasit1 天前
笔记：Qt C++建立子线程做一个socket TCP常连接通信
c++·qt·tcp/ip
全栈老石1 天前
拆解低代码引擎核心：元数据驱动的"万能表"架构
数据库·低代码
倔强的石头_2 天前
kingbase备份与恢复实战（二）—— sys_dump库级逻辑备份与恢复（Windows详细步骤）
数据库
jiayou643 天前
KingbaseES 实战：深度解析数据库对象访问权限管理
数据库
李广坤4 天前
MySQL 大表字段变更实践（改名 + 改类型 + 改长度）
数据库
爱可生开源社区5 天前
2026 年，优秀的 DBA 需要具备哪些素质？
数据库·人工智能·dba
热门推荐
01GitHub 镜像站点02OpenClaw 使用和管理 MCP 完全指南03OpenClaw + 飞书（Feishu）环境搭建指南04OpenClaw优化飞书API 额度已耗尽问题05Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services06Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤07Window 10部署openclaw报错node.exe : npm error code 12808小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）09OpenClaw大龙虾机器人完整安装教程10网站改了域名，如何查找？