以SQLite数据库为例，学习数据库的基本操作，使用QSql模块查询、编辑数据并在前端展示。
SQLite数据库的基础知识：
QSql模块的基本操作：
QT的QSql 模块提供了对各种数据库的访问和操作功能，使得在 PySide 应用程序中与数据库进行交互变得相对简单。
基本概念
数据库连接（QSqlDatabase）：
QSqlDatabase 类表示与数据库的连接。可以创建多个数据库连接，每个连接可以有不同的配置。
事务（Transactions）：
QSqlDatabase 支持数据库事务，数据库事务将多个数据库操作组合在一起，比如对数据库进行插入、更新、删除等操作。如果这些操作全部成功，就可以提交，让这些操作永久生效；如果其中有任何一个操作失败，那么就全部回滚，即撤销所有已经执行的操作，让数据库恢复到事务开始之前的状态。这样可以保证数据库的一致性和完整性。
查询（QSqlQuery）：
QSqlQuery 类用于执行 SQL 语句和查询数据。通过数据库连接创建 QSqlQuery 对象，并执行 SELECT、INSERT、UPDATE、DELETE 等 SQL 操作。
基本使用方法
-
导入模块：
from PySide6.QtSql import QSqlDatabase, QSqlQuery, QSqlTableModel, QSqlQueryModel
from PySide6.QtWidgets import QApplication, QTableView -
创建数据库连接、注册数据库驱动：
db = QSqlDatabase.addDatabase('QSQLITE') # 使用 SQLite 数据库
db.setDatabaseName('example.db')
if not db.open():
print("无法打开数据库")
exit(1) -
执行 SQL 查询：
不使用数据模型，创建 QSqlQuery 对象并执行 SQL 语句：
query = QSqlQuery()
query.exec_("CREATE TABLE IF NOT EXISTS persons (id INTEGER PRIMARY KEY, name VARCHAR(100), age INTEGER)")
query.exec_("INSERT INTO persons (name, age) VALUES ('张三', 30)")
query.exec_("INSERT INTO persons (name, age) VALUES ('李四', 25)")
- 使用数据模型：
创建 QSqlTableModel 并设置表：
model = QSqlTableModel()
model.setTable('persons')
model.select()
- 绑定到视图：
创建 QTableView 并设置模型：
app = QApplication([])
view = QTableView()
view.setModel(model)
view.show()
app.exec_()
事务处理
-
开始事务：
db.transaction() -
提交事务：
db.commit() -
回滚事务：
db.rollback()
示例代码
以下是一个完整的示例，展示了如何使用 PySide 的 QSql 模块创建数据库、插入数据，并将数据展示在 QTableView 中：
import sys
from PySide6.QtSql import QSqlDatabase, QSqlQuery, QSqlTableModel
from PySide6.QtWidgets import QApplication, QTableView
def create_connection():
db = QSqlDatabase.addDatabase('QSQLITE')
db.setDatabaseName('example.db')
if not db.open():
print("无法打开数据库")
return False
return True
def create_table():
query = QSqlQuery()
query.exec_("CREATE TABLE IF NOT EXISTS persons (id INTEGER PRIMARY KEY, name VARCHAR(100), age INTEGER)")
def insert_data():
query = QSqlQuery()
query.exec_("INSERT INTO persons (name, age) VALUES ('张三', 30)")
query.exec_("INSERT INTO persons (name, age) VALUES ('李四', 25)")
def main():
if not create_connection():
sys.exit(1)
create_table()
insert_data()
app = QApplication(sys.argv)
model = QSqlTableModel()
model.setTable('persons')
model.select()
view = QTableView()
view.setModel(model)
view.show()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
一些容易混淆的概念：
前端显示的QTableView 和 QTableWidget ：
QTableView和QTableWidget的关系与区别-CSDN博客
QTableView：适用于需要高度灵活性、复杂数据管理或处理大数据集的场景。它要求开发者管理模型和视图的分离。
**QTableWidget：**适用于简单的表格需求，提供便捷的方法来操作表格数据，但灵活性和性能可能受限。
在实际的使用中，结合QSqlTableModel 和 QSqlQueryModel的话，QTableView的语句要更简洁一些。
数据模型的QSqlTableModel 和 QSqlQueryModel：
Pyside6（PyQT5）中的QTableView与QSqlQueryModel、QSqlTableModel的联合使用-CSDN博客
QSqlTableModel 和 QSqlQueryModel 是用于将数据库数据绑定到视图（如 QTableView）的模型类。QSqlTableModel 提供了编辑功能，而 QSqlQueryModel 通常用于只读数据展示。
查询类QSqlQuery和QSqlQueryModel的关系
QSqlQuery 是一个用于执行 SQL 语句，实现各种 SQL 操作的类。QSqlQueryModel是一个数据模型类。QSqlQueryModel内部使用 QSqlQuery 来执行 SQL 查询并获取数据。当为QSqlQueryModel设置一个查询时，它会使用 QSqlQuery 来执行该查询，并将结果存储在模型中，以便视图可以显示这些数据。
PySide6(PyQT)，QSqlQueryModel与QSqlQuery的关系-CSDN博客
使用QDataWidgetMapper的简单范例
QDataWidgetMapper是 Qt 框架中的一个类。它通常用于将数据模型中的数据映射到用户界面上的小部件（widgets）。例如，可以将数据库中的一条记录映射到一组输入框、下拉列表等界面元素上，方便用户查看和编辑数据。它提供了一种方便的方式来管理数据和界面之间的交互。
import sys
from PySide6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QLineEdit, QPushButton, QDataWidgetMapper
from PySide6.QtSql import QSqlDatabase, QSqlTableModel
from PySide6.QtCore import Qt
class MainWindow(QMainWindow):
def __init__(self):
super().__init__()
# 设置数据库
db = QSqlDatabase.addDatabase("QSQLITE")
db.setDatabaseName("users.db")
if not db.open():
print("无法打开数据库")
return
# 创建模型
self.model = QSqlTableModel()
self.model.setTable("users")
self.model.select()
# 创建映射器
self.mapper = QDataWidgetMapper()
self.mapper.setModel(self.model)
# 创建控件
self.nameEdit = QLineEdit()
self.emailEdit = QLineEdit()
# 设置映射
self.mapper.addMapping(self.nameEdit, 1) # 假设姓名在第1列
self.mapper.addMapping(self.emailEdit, 2) # 假设邮箱在第2列
# 创建布局
layout = QVBoxLayout()
layout.addWidget(self.nameEdit)
layout.addWidget(self.emailEdit)
layout.addWidget(QPushButton("Next", clicked=self.onNext))
layout.addWidget(QPushButton("Previous", clicked=self.onPrevious))
# 创建中央部件
centralWidget = QWidget()
centralWidget.setLayout(layout)
self.setCentralWidget(centralWidget)
# 初始化映射器
self.mapper.toFirst()
def onNext(self):
if self.mapper.currentIndex() < self.model.rowCount() - 1:
self.mapper.toNext()
def onPrevious(self):
if self.mapper.currentIndex() > 0:
self.mapper.toPrevious()
if __name__ == "__main__":
app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec())