Qt SQL 模型类对比与选用指南

流星划过天际c

于 2025-05-19 23:16:15 发布

阅读量781

点赞数 10

分类专栏： Qt总结文章标签： qt 开发语言数据库

本文链接：https://blog.youkuaiyun.com/treehan/article/details/148076711

版权

Qt总结专栏收录该内容

16 篇文章

订阅专栏

Qt 提供了多个用于数据库操作的类，每个类都有其特定的用途和适用场景。下面我将详细对比 QSqlTableModel、QSqlQueryModel、QSqlQuery 和 QSqlRelationalTableModel 的区别，并给出选用建议。

1. 核心类对比

特性	QSqlTableModel	QSqlQueryModel	QSqlQuery	QSqlRelationalTableModel
继承关系	QSqlQueryModel	QAbstractTableModel	QObject	QSqlTableModel
数据源	单个表	任意SQL查询结果	任意SQL语句	主表+外键关联表
可编辑性	支持	只读	N/A	支持
自动生成SQL	是	否	否	是
视图集成	直接支持	直接支持	需要手动处理	直接支持
关系支持	不支持	不支持	手动处理	支持外键关系
使用复杂度	简单	中等	较高	中等
典型用途	单表CRUD操作	只读数据显示	复杂SQL操作	主从表数据显示与编辑

2. 详细解析与选用场景

2.1 QSqlQuery

核心特点：

最低层的SQL操作接口
直接执行任意SQL语句
需要手动处理结果集

适用场景：

执行DDL语句（创建表、修改表结构等）
执行存储过程
复杂的多表联合查询
批量数据操作
性能要求极高的场景

示例代码：

QSqlQuery query;
query.exec("SELECT e.name, d.department_name FROM employees e "
           "JOIN departments d ON e.dept_id = d.id "
           "WHERE e.salary > 5000");

while (query.next()) {
    QString name = query.value(0).toString();
    QString dept = query.value(1).toString();
    qDebug() << name << "works in" << dept;
}

2.2 QSqlQueryModel

核心特点：

只读数据模型
可以包装任意SQL查询结果
可直接绑定到视图组件

适用场景：

只读报表显示
复杂查询结果显示
不需要编辑的简单数据展示

示例代码：

QSqlQueryModel *model = new QSqlQueryModel;
model->setQuery("SELECT name, salary FROM employees WHERE department = 'IT'");

// 自定义表头
model->setHeaderData(0, Qt::Horizontal, tr("姓名"));
model->setHeaderData(1, Qt::Horizontal, tr("薪资"));

QTableView *view = new QTableView;
view->setModel(model);

2.3 QSqlTableModel

核心特点：

面向单个数据库表
支持读写操作
自动生成基本SQL语句
提供编辑策略控制

适用场景：

单表的CRUD操作
需要编辑功能的表格视图
简单的数据管理界面

示例代码：

QSqlTableModel *model = new QSqlTableModel;
model->setTable("employees");
model->setEditStrategy(QSqlTableModel::OnManualSubmit);
model->select();

// 修改数据
model->setData(model->index(0, 1), "张三");

// 提交更改
model->submitAll();

2.4 QSqlRelationalTableModel

核心特点：

继承自QSqlTableModel
支持外键关系
自动处理关联表数据显示
提供关系编辑功能

适用场景：

主从表关系的数据显示
需要显示外键关联的文本而非ID
带有关联表的数据编辑界面

示例代码：

QSqlRelationalTableModel *model = new QSqlRelationalTableModel;
model->setTable("employees");

// 设置关系：将dept_id显示为departments表的name字段
model->setRelation(2, QSqlRelation("departments", "id", "name"));

model->select();

QTableView *view = new QTableView;
view->setModel(model);

// 对关系字段使用组合框编辑器
view->setItemDelegate(new QSqlRelationalDelegate(view));

3. 选用决策流程图

开始
│
├── 需要执行任意SQL或DDL操作？ → 选用QSqlQuery
│
├── 只显示数据且不需要编辑？
│ ├── 数据来自简单查询？ → 选用QSqlQueryModel
│ └── 数据来自复杂查询？ → 选用QSqlQueryModel或QSqlQuery
│
├── 需要编辑单表数据？ → 选用QSqlTableModel
│
└── 需要处理主从表关系数据？ → 选用QSqlRelationalTableModel

4. 性能与复杂度权衡

灵活性 vs 便利性：
- QSqlQuery提供最大灵活性但需要更多代码
- QSqlXxxModel类更便利但功能受限
性能考虑：
- 对于大数据量操作，QSqlQuery通常性能更好
- 模型类会带来额外开销但简化了开发
维护性：
- 模型类代码更易于维护
- 直接SQL在复杂业务中可能更清晰

5. 组合使用建议

在实际项目中，常常需要组合使用这些类：

// 使用QSqlQuery执行复杂查询获取统计数据
QSqlQuery statsQuery("SELECT dept, AVG(salary) FROM employees GROUP BY dept");

// 使用QSqlTableModel管理员工数据编辑
QSqlTableModel *empModel = new QSqlTableModel;
empModel->setTable("employees");

// 使用QSqlRelationalTableModel显示带部门名称的列表
QSqlRelationalTableModel *relModel = new QSqlRelationalTableModel;
relModel->setTable("employees");
relModel->setRelation(2, QSqlRelation("departments", "id", "name"));