QSqlDatabase二三事

迷南。 2023-07-25 11:21 22阅读 0赞

**目录**

0.前言

1.连接

创建连接

自定义的连接名

2.操作

打开数据库

事务操作

3.问题

4.参考

--------------------

# 0.前言 #

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

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

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

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

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

# 1.连接 #

### 创建连接 ###

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

![202004141922088.png][]

我们一般用第一种，使用 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.

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

![20200414193859349.png][]

### 自定义的连接名 ###

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

![20200414194709754.png][]

此时 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(); //回滚

# 3.问题 #

### MySQL open 后在代码中创建的数据库，但是 QSqlTableModel 不显示内容 ###

测试发现，在使用 MySQL 时，如果没有设置 DatabaseName ，会导致 QSqlTableModel 不显示内容。如果是在代码中创建的数据库，可以先 close() 再 open()，这样就能正常显示了。

# 4.参考 #

官方文档：[https://doc.qt.io/qt-5/qsqldatabase.html][https_doc.qt.io_qt-5_qsqldatabase.html]

官方文档：[https://doc.qt.io/qt-5/threads-modules.html][https_doc.qt.io_qt-5_threads-modules.html]

博客（Qt中操作SQLite数据库）：[https://blog.csdn.net/gongjianbo1992/article/details/88070605][https_blog.csdn.net_gongjianbo1992_article_details_88070605]

博客（Qt5.12+VS2019编译32位MYSQL8.0驱动）：[https://blog.csdn.net/gongjianbo1992/article/details/105211210][https_blog.csdn.net_gongjianbo1992_article_details_105211210]

[202004141922088.png]: /images/20230528/1835257c70c54a7fbbb4645d4ea7459b.png
[20200414193859349.png]: /images/20230528/1c6c78c503d446a791cba9479e53ffa4.png
[20200414194709754.png]: /images/20230528/dfd8090420ae4ce6a41f4fa7f2e0f7b3.png
[https_doc.qt.io_qt-5_qsqldatabase.html]: https://doc.qt.io/qt-5/qsqldatabase.html
[https_doc.qt.io_qt-5_threads-modules.html]: https://doc.qt.io/qt-5/threads-modules.html
[https_blog.csdn.net_gongjianbo1992_article_details_88070605]: https://blog.csdn.net/gongjianbo1992/article/details/88070605
[https_blog.csdn.net_gongjianbo1992_article_details_105211210]: https://blog.csdn.net/gongjianbo1992/article/details/105211210