目录
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(); //回滚
3.问题
MySQL open 后在代码中创建的数据库,但是 QSqlTableModel 不显示内容
测试发现,在使用 MySQL 时,如果没有设置 DatabaseName ,会导致 QSqlTableModel 不显示内容。如果是在代码中创建的数据库,可以先 close() 再 open(),这样就能正常显示了。
4.参考
官方文档:https://doc.qt.io/qt-5/qsqldatabase.html
官方文档:https://doc.qt.io/qt-5/threads-modules.html
博客(Qt中操作SQLite数据库):https://blog.csdn.net/gongjianbo1992/article/details/88070605
博客(Qt5.12+VS2019编译32位MYSQL8.0驱动):https://blog.csdn.net/gongjianbo1992/article/details/105211210