Python GUI教程(十四):在PyQt5中使用数据库



在桌面图像化界面编程中,我们通常需要将一些数据或配置信息存储在本地。在本地进行数据的存储,我们可以直接使用文本文件,比如ini文件、csv文件、json文件等,或者是使用文件型的数据库(比如sqlit3)进行存储。

PyQt5的SQL数据库支持

Qt平台对SQL编程有着良好的支持,PyQt5也一并继承了过来。在PyQt5中,QtSql子模块提供对SQL数据库的支持:

从上图我们可以发现,QtSQL模块中包含了很多个类,这些类归总起来主要包含三大部分:

  • 驱动层,用于提供特定数据库与SQL API接口之间的低级连接功能;其中包括QSqlDriver、QSqlDriverCreatorBase、QSqlResult;
  • SQL API层,用于提供对数据库的访问。通常来说,我们会使用QSqlDatabase建立数据库连接,使用QSqlQuery等类实现数据库的交互(执行SQL语句)。此外还有QSqlError、QSqlField、QSqlIndex、QSqlRecord等类。
  • 用户界面操作层,用于将数据库操作的数据链接到PyQt相应的数据小部件,将数据和操作展示在Qt界面中。这些类包括:QSqlQueryModel、QSqlTableModel等。

在这些类中,每个类都有自己特定的用途,其中:

  • QSQL:包含整个Qt SQL模块中使用的各种标识符
  • QSqlDatabase:处理与数据库的连接
  • QSqlDriver:用于访问特定SQL数据库的抽象基类
  • QSqlDriverCreator:模板类,为特定驱动程序类型提供SQL驱动程序工厂
  • QSqlDriverCreatorBase:SQL驱动程序工厂的基类
  • QSqlError:SQL数据库错误信息
  • QSqlField:处理SQL数据库表和视图中的字段
  • QSqlIndex:用于操作和描述数据库索引的函数
  • QSqlQuery:执行和操作SQL语句的方法
  • QSqlQueryModel:SQL结果集的只读数据模型
  • QSqlRecord:封装数据库记录
  • QSqlRelationalTableModel:具有外键支持的单个数据库表的可编辑数据模型
  • QSqlResult:用于从特定SQL数据库访问数据的抽象接口
  • QSqlTableModel:单个数据库表的可编辑数据模型

在实际的PyQt编程中,我们很少使用驱动层的类,多通过API层的来建立数据库连接、进行数据库查询等,然后通过用户界面操作层的类将数据结果显示在图形界面中。下面我们就来简单使用一下。

在PyQt5中简单使用数据库

创建一个UI界面

首先,我们通过PyQt5创建一个基本的图形界面。这个界面由两个部分组成:

  • 按钮操作层:用来通过按钮进行数据库操作;
  • 数据库展示层:用来展示数据库表的信息;

UI界面的代码如下所示:

最终显示出来的UI界面如下图所示:

连接一个数据库

在上面创建的UI界面中,我们有一个“创建数据库”的按钮,这个按钮我们用来建立一个数据库连接。

Qt中内置了好几个数据库的驱动程序,也就是说我们可以直接在PyQt中对这些数据库进行操作。这些内置的数据库包括:

  • IBM DB2,驱动名为QDB2;
  • Borland InterBase,驱动名为QIBASE;
  • MySQL,驱动名为QMYSQL;
  • Oracle,驱动名为QOCI;
  • Microsoft SQL Server和其他符合ODBC的数据库,驱动名为QODBC;
  • PostgreSQL,驱动名为QPSQL;
  • SQLite2,驱动名为QSQLITE2;
  • SQLite3,驱动名为QSQLITE;

通过这些驱动名,我们可以借助QSqlDatabase类的addDatabase方法添加某个数据库的连接,比如建立一个MySQL数据库的连接为:

为了方便演示,在此我们使用Sqlite数据库。

在MainUi()类中,我们创建一个名为create_db()的方法:

在这个方法中,我们自定义数据库名并创建一个sqlite数据库,然后在这个数据库中创建了一个名为zmister的数据库表,最后在zmister数据库表中插入了三条数据。

接下来,我们将这个方法绑定到【创建数据库】按钮的点击事件上:

这样,当我们点击【创建数据库】按钮的时候,UI界面会弹出一个文本输入框供我们输入数据库的名称,然后创建一个数据表并插入数据:

完成操作之后,会发现文件同级目录下多出了一个zmister.sqlite文件,我们使用SQLite Expert等SQLite数据库可视化软件打开它:

这样,我们就成功在PyQt5中创建连接并写入操作了一个数据库。

在UI界面查看和修改数据

上面我们创建了一个SQLite数据库并在其中写入了三条数据,如何将数据表中的数据显示在UI界面中呢。我们可以借助QSqlTableModel类来实现。

还记得我们在创建UI界面的时候,在界面的右方放置了一个QTableView()部件,我们的数据库数据将显示在这上面。

继续在MainUi()类中创建一个名为view_data()的方法,在方法中实例化一个QSqlTableModel(),并将QTableView()部件的model模型设置为实例化后的QSqlTableModel():

然后,将view_data()方法绑定在UI界面的【浏览数据】按钮的点击事件中:

这样,我们在点击【浏览数据】按钮的时候,会将zmister表中的所有数据显示出来:

除了简单的将数据显示在UI界面上,我们还可以直接在UI界面上修改数据:

添加和删除数据

完成查和改的SQL操作之后,我们接着来了解一下如何添加数据和删除数据。

添加数据通过数据模型对象的insertRows()方法来实现,删除数据则通过数据模型对象的removeRow()方法来实现。

我们继续在MainUi()类中创建两个方法:add_row_data()和del_row_data():

然后将这两个方法分别绑定在【添加一行】和【删除一行】按钮的点击事件上:

这样就实现了UI界面上的添加数据和删除数据:

这样,我们就基本实现了使用PyQt5对数据库的增删改查操作,更加详细的使用和说明请参考Qt文档。

  1. hahaxiong说道:

    好,继续,支持你!

  2. boke112导航说道:

    博主,你好,boke112导航特来拜会,已将贵站收录到博客导航的建站技术类,谢谢支持!

  3. titika说道:

    代码复制 不了。

    1. 州的先生说道:

      已经修复

发表评论

电子邮件地址不会被公开。