Qt开发：QSqlDatabase的常见用法

原创最新推荐文章于 2026-08-19 11:55:17 发布 2.1k 阅读 AI写同款

TechNomad

787粉丝183篇原创

关注

Qt QSqlDatabase类详解 QSqlDatabase类提供了一个通过连接访问数据库的接口，QSqlDatabase的一个实例表示连接，该连接通过一个受支持的数据库驱动程序提供对数据库的访问，该驱动程序是从QSqlDriver派生的，或者，您可以从QSqlDriver中子类化自己的数据库驱动程序... 阅读详情

AI摘要

本文介绍了Qt中QSqlDatabase的常见用法。QSqlDatabase用于管理和访问数据库连接，支持多种数据库引擎。其使用流程包括初始化数据库驱动、连接数据库、执行SQL查询和关闭连接。还介绍了常用函数，以及创建、插入、查询、更新和删除数据表数据的操作。

文章目录

一、概述

QSqlDatabase 是 Qt 中用于管理和访问数据库连接的类。它提供了一种统一的方式来连接不同的数据库引擎，执行 SQL 查询和操作数据库。它支持多种数据库管理系统（如 SQLite、MySQL、PostgreSQL 等），并提供了统一的 API 来进行数据库操作。
特点：

支持连接多种数据库引擎，通过相应的驱动程序进行连接。

提供了对数据库连接的管理和控制，包括连接建立、断开、事务控制等功能。

可以执行 SQL 查询、事务操作、元数据查询等数据库操作。

二、使用流程

1.初始化数据库驱动
在使用 QSqlDatabase 之前，需要初始化并加载要使用的数据库驱动。常见的数据库驱动包括 QSQLITE、QMYSQL、QPSQL 等。

#include <QSqlDatabase>
#include <QSqlError>
#include <QDebug>

int main(int argc, char *argv[]) 
{
   
    
   	QCoreApplication a(argc, argv);
   
   	// 初始化数据库驱动
   	QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
   	// 如果是 MySQL 或 PostgreSQL 等，可以将 "QSQLITE" 替换成对应的驱动名称
   	// QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");
   	// QSqlDatabase db = QSqlDatabase::addDatabase("QPSQL"); 
   
   	return a.exec();
}

2.连接数据库
使用 setHostName()、setDatabaseName()、setUserName()、setPassword() 等方法设置数据库连接的参数，然后调用 open() 方法打开数据库连接。

#include <QSqlDatabase>
#include <QSqlError>
#include <QDebug>

int main(int argc, char *argv[]) 
{
   
    
   	QCoreApplication a(argc, argv);
   
   	// 设置数据库连接参数
  	db.setHostName("localhost");
  	db.setDatabaseName("mydatabase");
  	db.setUserName("username");
  	db.setPassword("password");

  	// 打开数据库连接
  	if (db.open()) {
   
   
     	qDebug() << "Database connected!";
  	} else {
   
   
     	qDebug() << "Error opening database:" << db.lastError().text();
  	}
   
   	return a.exec();
}

3.执行 SQL 查询
一旦数据库连接成功，可以通过 QSqlQuery 对象执行 SQL 查询和操作。

#include <QSqlDatabase>
#include <QSqlError>
#include <QDebug>

int main(int argc, char *argv[]) 
{
   
    
   	QCoreApplication a(argc, argv);
   
   	// 创建 QSqlQuery 对象，并执行 SQL 查询
	QSqlQuery query;
	if (query.exec("SELECT * FROM mytable")) {
   
   
    	while (query.next()) {
   
   
        	QString name = query.value(0).toString();
        	int age = query.value