QSqlDatabase二三事

最新推荐文章于 2025-02-22 22:03:12 发布

龚建波

最新推荐文章于 2025-02-22 22:03:12 发布

阅读量5.4k

点赞数 3

分类专栏： Qt 略知一二文章标签： QSqlDatabase 数据库 Qt

本文链接：https://blog.csdn.net/gongjianbo1992/article/details/105518870

版权

Qt 略知一二专栏收录该内容

92 篇文章

订阅专栏

0.前言

QSqlDatabase 类用于处理与数据库的连接，提供用于通过连接访问数据库的接口，一个 QSqlDatabase 实例就代表了一个连接。

Qt 数据库模块使用前需在 pro 工程文件中加上：Qt += sql

引入头文件后，看看有哪些驱动：

qDebug()<<QSqlDatabase::drivers();
// ("QSQLITE", "QMYSQL", "QMYSQL3", "QODBC", "QODBC3", "QPSQL", "QPSQL7")

（从 Qt5.12.4 开始默认没有 MySQL 的驱动插件，我们需要自己编译）

1.连接

创建连接

接下来是创建连接，有三种方式：

我们一般用第一种，使用 dirver 的类型名来创建，第二个参数为连接名，如果你程序里只有一个地方操作数据库，那用默认连接名就行了：

    QSqlDatabase db;

    // 使用默认连接名
    if(QSqlDatabase::contains(QSqlDatabase::defaultConnection)){
        db = QSqlDatabase::database(QSqlDatabase::defaultConnection);
    }else{
        db = QSqlDatabase::addDatabase("QMYSQL");
    }
    //QSqlDatabase::defaultConnection 是字符串 "qt_sql_default_connection"
    
    // 使用自定义连接名
    if(QSqlDatabase::contains("MyConnection")){
        db = QSqlDatabase::database("MyConnection");
    }else{
        db = QSqlDatabase::addDatabase("QMYSQL","MyConnection");
    }

代码中先是判断了连接列表是否包含此连接，如果创建两个相同连接名的示例，会报错：

QSqlDatabasePrivate::removeDatabase: connection 'qt_sql_default_connection' is still in use, all queries will cease to work.
QSqlDatabasePrivate::addDatabase: duplicate connection name 'qt_sql_default_connection', old connection removed.

需要注意的是，连接只能在创建它的线程中使用。不支持在线程之间移动连接或者从其他线程创建查询。所以，如果我们需要多个线程操作数据库的话，可以在每个线程单独创建连接：

自定义的连接名

对于自定义的连接名，在进行查询等操作时，需要把相关类的 QSqlDatabase 设置下。不然会出现类似（QSqlQuery::exec: database not open）的错误：

此时 QSqlQuery 应该是这样构造的：

    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL","MyConnection");
    QSqlQuery query(db);

QSqlTableModel 亦复如是；

    QSqlTableModel *model = new QSqlTableModel(this,db);

不然对应的 TableView 无法加载出数据。

2.操作

打开数据库

对于 SQLite，我们只需要设置数据库文件路径就行了：

    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    //设置数据库路径，不存在则创建
    db.setDatabaseName("sqltest.db");    
    //打开数据库
    if(db.open()){
        qDebug()<<"open success";
        //关闭数据库
        db.close();
    }

如果需要在内存中创建数据库，而不是指定一个文件，可以： setDatabaseName(":memory:");

对于 MySQL，设置如下：

    // 把MySQL的配置复制粘贴过来
    db.setHostName("localhost"); 
    db.setPort(3306);
    db.setUserName("root");
    db.setPassword("qq654344883");
    // 如果不设置数据库名的话，SQL语句加上数据库名
    //sql.setDatabaseName("mysql_db");
    if(db.open()){
        qDebug()<<"open succeeded";
    }else{
        qDebug()<<"open failed";
    }

如果不设置数据库名的话，SQL 语句加上数据库名，如：

query.exec("select * from db_name.table_name;");

事务操作

提供了三个函数分别进行开启事务、提交、回滚操作：

    // 可以判断该驱动程序是否支持事务，SQLite和MySQL的是支持的
    //if(db.driver()->hasFeature(QSqlDriver::Transactions)){}
    db.transaction(); //开启事务
    //开启事务后进行增删改操作
    db.commit(); //提交
    db.rollback(); //回滚