一篇文章详解Qt中如何访问数据库

前言

在Qt中访问数据库涉及到几个关键步骤，主要包括加载数据库驱动、建立数据库连接、执行SQL语句、读取结果等。下面将详细介绍这些步骤，并给出一个简单的示例，这里假设使用的是SQLite数据库。

记得首先在pro文件中添加QT += sql

1. 加载数据库驱动

Qt通过数据库驱动程序来支持不同类型的数据库，例如SQLite、MySQL、PostgreSQL等。在实际使用前，通常需要确保已经包含了相应的数据库驱动模块。对于SQLite，由于Qt内置了对其的支持，无需额外安装驱动。

#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>

// 如果使用其他数据库，可能需要包含对应的头文件，例如：
// #include <QMYSQLDriver> // 对于MySQL
// #include <QPSQLDriver> // 对于PostgreSQL

注意： 当前Qt是否已经安装将要使用的数据库驱动，可以使用QSqlDatabase::drivers()去查看

#include <QtSql>  
#include <QDebug>  
  
int main(int argc, char *argv[]) {  
    QCoreApplication a(argc, argv);  
  	//输出所有已经支持的数据库驱动
    QStringList drivers = QSqlDatabase::drivers();  
    foreach (const QString &driver, drivers) {  
        qDebug() << driver;  
    }  
  
    return a.exec();  
}

2. 创建数据库连接

创建数据库连接通常涉及指定数据库类型（如果是SQLite，则通常不需要用户名、密码和数据库地址，因为SQLite数据库文件是本地文件）。

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); // 对于SQLite
// 或者
// QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); // 对于MySQL
// QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL"); // 对于PostgreSQL

db.setHostName("localhost"); // 对于远程数据库，设置主机名或IP
db.setDatabaseName("/path/to/mydatabase.db"); // 对于SQLite，这是数据库文件路径；对于其他数据库则是数据库名
db.setUserName("username"); // 非SQLite数据库的用户名
db.setPassword("password"); // 非SQLite数据库的密码

if (!db.open()) {
    qDebug() << "Failed to connect to database: " << db.lastError().text();
    return false; // 连接失败
}

3. 执行SQL查询或命令

使用QSqlQuery类执行SQL语句。

QSqlQuery query;

// 插入数据
query.prepare("INSERT INTO MyTable (column1, column2) VALUES (?, ?)");
query.addBindValue(value1);
query.addBindValue(value2);
if (!query.exec()) {
    qDebug() << "Insert error: " << query.lastError().text();
} else {
    qDebug() << "Row inserted successfully.";
}

// 查询数据
query.clear();
query.prepare("SELECT * FROM MyTable WHERE id = ?");
query.bindValue(0, someId);
if (query.exec()) {
    while (query.next()) {
        QString value1 = query.value(0).toString();
        int value2 = query.value(1).toInt();
        // ... 处理查询结果 ...
    }
} else {
    qDebug() << "Select error: " << query.lastError().text();
}

4. 关闭数据库连接

在完成所有数据库操作后，关闭连接以释放资源。

db.close();

示例完整代码片段

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>

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

    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName(":memory:"); // 使用内存数据库，也可以替换为实际文件路径

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

    // 创建表
    QSqlQuery createQuery;
    createQuery.exec("CREATE TABLE IF NOT EXISTS MyTable (id INTEGER PRIMARY KEY, column1 VARCHAR(40), column2 INT)");

    // 插入数据
    QSqlQuery insertQuery;
    insertQuery.prepare("INSERT INTO MyTable (column1, column2) VALUES (?, ?)");
    insertQuery.addBindValue("Example Value");
    insertQuery.addBindValue(123);
    if (!insertQuery.exec()) {
        qDebug() << "Insert error: " << insertQuery.lastError().text();
    } else {
        qDebug() << "Row inserted successfully.";
    }

    // 查询数据
    QSqlQuery selectQuery;
    selectQuery.prepare("SELECT * FROM MyTable");
    if (selectQuery.exec()) {
        while (selectQuery.next()) {
            QString column1Value = selectQuery.value(1).toString();
            int column2Value = selectQuery.value(2).toInt();
            qDebug() << "Column1: " << column1Value << ", Column2: " << column2Value;
        }
    } else {
        qDebug() << "Select error: " << selectQuery.lastError().text();
    }

    db.close();

    return a.exec();
}

以上代码演示了如何使用Qt连接SQLite数据库，执行创建表、插入数据和查询数据的操作。

注意

• 对于不同的数据库类型，配置连接参数的方式会有所不同，但执行SQL的基本模式是相似的。
• 上述代码中使用的Sqlite数据库的内存模式。访问速度非常快。适合作为临时的缓存数据库使用。

打开多个数据库

在Qt程序中同时打开和操作多个数据库，可以通过创建多个QSqlDatabase实例来实现。每个数据库实例都有自己的名字（connection name），这样可以区分不同数据库连接。以下是一个简单的示例，展示如何同时打开两个SQLite数据库：

#include <QApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>

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

    // 打开第一个SQLite数据库
    QSqlDatabase db1 = QSqlDatabase::addDatabase("QSQLITE");
    db1.setDatabaseName("first_db.sqlite");
    if (!db1.open()) {
        qDebug() << "Failed to open the first database: " << db1.lastError().text();
        return 1;
    }

    // 执行第一个数据库的查询
    QSqlQuery query1(db1);
    query1.exec("CREATE TABLE IF NOT EXISTS Table1 (ID INTEGER PRIMARY KEY, Name TEXT)");
    if (!query1.isActive())
        qDebug() << "Error creating table in first DB: " << query1.lastError().text();

    // 打开第二个SQLite数据库
    QSqlDatabase db2 = QSqlDatabase::addDatabase("QSQLITE");
    db2.setDatabaseName("second_db.sqlite");
    if (!db2.open()) {
        qDebug() << "Failed to open the second database: " << db2.lastError().text();
        db1.close();
        return 1;
    }

    // 执行第二个数据库的查询
    QSqlQuery query2(db2);
    query2.exec("CREATE TABLE IF NOT EXISTS Table2 (ID INTEGER PRIMARY KEY, Name TEXT)");
    if (!query2.isActive())
        qDebug() << "Error creating table in second DB: " << query2.lastError().text();

    // 不论操作成功与否，记得在不再使用时关闭数据库连接
    db1.close();
    db2.close();

    return a.exec();
}

在上述示例中，我们创建了两个不同的SQLite数据库连接，并分别为它们创建了表。当然，你可以根据需要连接不同类型（如MySQL、PostgreSQL等）的数据库，只需在调用addDatabase时指定正确的数据库驱动名称即可。

务必注意，当在多线程环境中操作数据库时，即使Qt的数据库模块是线程安全的，也应该确保在同一时刻仅在一个线程中操作单个数据库连接，或者正确地管理线程间的同步，防止数据竞争问题。同时，也要确保在不再需要时关闭数据库连接，以避免资源泄露。

使用建议

• 数据库处理通常在主线程，如果必要在其他线程中访问数据库，切记在哪个线程访问数据库就在哪个线程中打开数据库。
• 如果甲方对数据库没有硬性要求，建议使用sqlite。
• 在连接远程数据库进行查询数据的时候，如果遇到访问缓慢情况，建议开启QSqlQuery 的setForwardOnly(true)。可以看到奇迹的发生。

总结