使用 PyQt 处理 SQL 数据库：基础知识

创建数据库连接

将应用程序连接到物理 SQL 数据库是使用 PyQt 开发数据库应用程序过程中的重要一步。要成功执行此步骤，您需要一些有关如何设置数据库的一般信息。

例如，您需要知道您的数据库是基于什么数据库管理系统构建的，并且您可能还需要用户名、密码、主机名等。

在本教程中，您将使用SQLite 3，这是一个经过充分测试的数据库系统，支持所有平台且配置要求最低。 SQLite 允许您直接读取和写入本地磁盘中的数据库，而不需要单独的服务器进程。这使其成为学习数据库应用程序开发的用户友好选项。

使用 SQLite 的另一个优点是该库随 Python 和 PyQt 一起提供，因此您无需安装任何其他内容即可开始使用它。

在 PyQt 中，您可以使用以下命令创建数据库连接QSql数据库班级。该类代表一个连接并提供访问数据库的接口。要创建连接，只需调用.addDatabase()在QSqlDatabase。这静态方法需要一个SQL驱动程序和一个可选的连接名称作为参数和回报数据库连接：

QSqlDatabase.addDatabase(
    driver, connectionName=QSqlDatabase.defaultConnection
)

第一个论点，driver, 是一个必需的参数，包含细绳包含一个名字PyQt 支持的 SQL 驱动程序。第二个论点，connectionName, 是一个可选参数，它包含带有连接名称的字符串。connectionName默认为QSqlDatabase.defaultConnection，通常保存字符串"qt_sql_default_connection".

如果您已经有一个名为connectionName，然后该连接被删除并替换为新连接，并且.addDatabase()将新添加的数据库连接返回给调用者。

致电.addDatabase()将数据库连接添加到可用连接列表中。这份清单是一个全球登记处PyQt 在幕后维护以跟踪应用程序中的可用连接。用有意义的方式注册您的联系connectionName会让你管理多个连接在数据库应用程序中。

创建连接后，您可能需要设置多个连接属性在上面。具体的属性集取决于您使用的驱动程序。一般来说，您需要设置数据库名称、用户名和访问数据库的密码等属性。

以下是可用于设置数据库连接的更常用属性或特性的 setter 方法的摘要：

请注意，您作为参数传递给的密码.setPassword()以纯文本形式存储，稍后可以通过调用检索.password()。这是一个严重的安全风险您应该避免在数据库应用程序中引入它。您将在本节中学习更安全的方法打开数据库连接在本教程的后面部分。

使用以下命令创建与 SQLite 数据库的连接QSqlDatabase，打开一个Python 交互式会话并输入以下代码：

>>> from PyQt5.QtSql import QSqlDatabase

>>> con = QSqlDatabase.addDatabase("QSQLITE")
>>> con.setDatabaseName("contacts.sqlite")

>>> con
<PyQt5.QtSql.QSqlDatabase object at 0x7f0facec0c10>

>>> con.databaseName()
'contacts.sqlite'

>>> con.connectionName()
'qt_sql_default_connection'

此代码将使用创建一个数据库连接对象"QSQLITE"作为连接的驱动程序和"contacts.sqlite"作为连接的数据库名称。由于您没有将连接名称传递给.addDatabase()，新创建的连接将成为您的默认连接，其名称为"qt_sql_default_connection".

对于 SQLite 数据库，数据库名称通常是文件名或包含数据库文件名的路径。您也可以使用特殊名称":memory:"对于内存数据库。

处理多个连接

在某些情况下，您可能需要使用与单个数据库的多个连接。例如，您可能希望使用每个用户的特定连接来记录用户与数据库的交互。

在其他情况下，您可能需要将应用程序连接到多个数据库。例如，您可能想要连接到多个远程数据库以收集数据来填充或更新本地数据库。

为了处理这些情况，您可以为不同的连接提供特定的名称，并按名称引用每个连接。如果您想为数据库连接指定一个名称，则将该名称作为第二个参数传递给.addDatabase():

>>> from PyQt5.QtSql import QSqlDatabase

>>> # First connection
>>> con1 = QSqlDatabase.addDatabase("QSQLITE", "con1")
>>> con1.setDatabaseName("contacts.sqlite")

>>> # Second connection
>>> con2 = QSqlDatabase.addDatabase("QSQLITE", "con2")
>>> con2.setDatabaseName("contacts.sqlite")

>>> con1
<PyQt5.QtSql.QSqlDatabase object at 0x7f367f5fbf90>
>>> con2
<PyQt5.QtSql.QSqlDatabase object at 0x7f3686dd7510>

>>> con1.databaseName()
'contacts.sqlite'
>>> con2.databaseName()
'contacts.sqlite'

>>> con1.connectionName()
'con1'
>>> con2.connectionName()
'con2'

在这里，您创建到同一数据库的两个不同连接，contacts.sqlite。每个连接都有自己的连接名称。您可以根据需要随时在代码中使用连接名称来获取对特定连接的引用。为此，您可以致电.database()带有连接名称：

>>> from PyQt5.QtSql import QSqlDatabase

>>> db = QSqlDatabase.database("con1", open=False)

>>> db.databaseName()
'contacts.sqlite'
>>> db.connectionName()
'con1'

在此示例中，您会看到.database()有两个参数：

1. connectionName保存您需要使用的连接名称。如果您不传递连接名称，则将使用默认连接。
2. open持有一个布尔值告诉我们的值.database()是否要自动打开连接。如果open是True（默认）并且连接未打开，则连接会自动打开。

这返回值的.database()是对名为的连接对象的引用connectionName。您可以使用不同的连接名称来获取对特定连接对象的引用，然后使用它们来管理数据库。

使用不同的 SQL Divers

到目前为止，您已经学习了如何使用创建数据库连接SQLite驱动程序。这不是 PyQt 中唯一可用的驱动程序。该库提供了一组丰富的 SQL 驱动程序，允许您根据您的具体需求使用不同类型的数据库管理系统：

驱动程序名称列包含标识符字符串你需要传递给.addDatabase()作为使用关联驱动程序的第一个参数。与 SQLite 驱动程序不同，当您使用不同的驱动程序时，您可能需要设置多个属性，例如数据库名称, 主机名 , 用户名， 和密码，以使连接正常工作。

数据库驱动程序源自QSql驱动程序。您可以通过子类化来创建自己的数据库驱动程序QSqlDriver，但该主题超出了本教程的范围。如果您有兴趣创建自己的数据库驱动程序，请查看如何编写自己的数据库驱动程序更多细节。

打开数据库连接

建立数据库连接后，您需要打开该连接才能与数据库进行交互。为此，您可以致电。打开（）在连接对象上。.open()有以下两种变体：

1. .open()使用当前连接值打开数据库连接。
2. .open(username, password)使用提供的打开数据库连接username和password.

两种变体均返回True如果连接成功。否则，他们会返回False。如果无法建立连接，您可以拨打.lastError()获取有关所发生事件的信息。此函数返回有关数据库报告的最后一个错误的信息。

下面是如何使用第一个变体打开 SQLite 数据库连接的示例.open():

>>> from PyQt5.QtSql import QSqlDatabase

>>> # Create the connection
>>> con = QSqlDatabase.addDatabase("QSQLITE")
>>> con.setDatabaseName("contacts.sqlite")

>>> # Open the connection
>>> con.open()
True
>>> con.isOpen()
True

在上面的示例中，您首先创建到 SQLite 数据库的连接并使用以下命令打开该连接.open()。自从.open()回报True，连接成功。此时，您可以使用以下命令检查连接.isOpen()，返回True如果连接打开并且False否则。

在实际应用程序中，在尝试对数据执行任何操作之前，您需要确保与数据库的有效连接。否则，您的应用程序可能会崩溃并失败。例如，如果您对尝试在其中创建数据库文件的目录没有写入权限怎么办？您需要确保正在处理打开连接时可能发生的任何错误。

一种常见的调用方式.open()就是把它包裹在一个条件语句。这允许您处理打开连接时可能发生的错误：

>>> import sys
>>> from PyQt5.QtSql import QSqlDatabase

>>> # Create the connection
>>> con = QSqlDatabase.addDatabase("QSQLITE")
>>> con.setDatabaseName("contacts.sqlite")

>>> # Open the connection and handle errors
>>> if not con.open():
...     print("Unable to connect to the database")
...     sys.exit(1)

将呼叫包装到.open()条件语句中允许您处理打开连接时发生的任何错误。这样，您可以在应用程序运行之前通知用户任何问题。请注意，应用程序退出时会显示退出状态的1，通常用于指示程序失败。

在上面的示例中，您使用.open()在交互式会话中，因此您可以使用打印（）向用户呈现错误消息。但是，在 GUI 应用程序中，不要使用print()，你通常使用Q消息框目的。和QMessageBox，您可以创建小对话框来向用户呈现信息。

下面是一个示例 GUI 应用程序，说明了处理连接错误的方法：

 1import sys
 2
 3from PyQt5.QtSql import QSqlDatabase
 4from PyQt5.QtWidgets import QApplication, QMessageBox, QLabel
 5
 6# Create the connection
 7con = QSqlDatabase.addDatabase("QSQLITE")
 8con.setDatabaseName("/home/contacts.sqlite")
 9
10# Create the application
11app = QApplication(sys.argv)
12
13# Try to open the connection and handle possible errors
14if not con.open():
15    QMessageBox.critical(
16        None,
17        "App Name - Error!",
18        "Database Error: %s" % con.lastError().databaseText(),
19    )
20    sys.exit(1)
21
22# Create the application's window
23win = QLabel("Connection Successfully Opened!")
24win.setWindowTitle("App Name")
25win.resize(200, 100)
26win.show()
27sys.exit(app.exec_())

这if第 14 行中的语句检查连接是否不成功。如果/home/目录不存在或者您没有写入权限，则调用.open()失败，因为无法创建数据库文件。在这种情况下，执行流程进入if语句代码块并在屏幕上显示一条消息。

如果将路径更改为可以写入的任何其他目录，则调用.open()将会成功，您将看到一个显示消息的窗口Connection Successfully Opened!您还将有一个名为的新数据库文件contacts.sqlite在选定的目录中。

请注意，您通过了None作为消息的家长因为，在显示消息时，您还没有创建窗口，因此消息框没有可行的父级。

执行静态 SQL 查询

要开始使用 PyQt 创建和执行查询，您将启动您最喜欢的代码编辑器或IDE并创建一个名为的 Python 脚本queries.py。保存脚本并向其中添加以下代码：

 1import sys
 2
 3from PyQt5.QtSql import QSqlDatabase, QSqlQuery
 4
 5# Create the connection
 6con = QSqlDatabase.addDatabase("QSQLITE")
 7con.setDatabaseName("contacts.sqlite")
 8
 9# Open the connection
10if not con.open():
11    print("Database Error: %s" % con.lastError().databaseText())
12    sys.exit(1)
13
14# Create a query and execute it right away using .exec()
15createTableQuery = QSqlQuery()
16createTableQuery.exec(
17    """
18    CREATE TABLE contacts (
19        id INTEGER PRIMARY KEY AUTOINCREMENT UNIQUE NOT NULL,
20        name VARCHAR(40) NOT NULL,
21        job VARCHAR(50),
22        email VARCHAR(40) NOT NULL
23    )
24    """
25)
26
27print(con.tables())

在此脚本中，您首先导入要使用的模块和类。然后使用创建数据库连接.addDatabase()使用 SQLite 驱动程序。您将数据库名称设置为"contacts.sqlite"并打开连接。

要创建您的第一个查询，您需要实例化QSqlQuery没有任何争论。查询对象就位后，您可以调用.exec()，传递基于字符串的 SQL 查询作为参数。这种查询称为静态查询因为它没有从查询外部获取任何参数。

上面的 SQL 查询创建一个名为contacts在你的数据库中。该表将包含以下四列：

上述脚本中的最后一行打印数据库中包含的表的列表。如果你运行脚本，然后您会注意到一个名为contacts.sqlite在您当前的目录中创建。你还会得到类似的东西['contacts', 'sqlite_sequence']打印在您的屏幕上。这列表包含数据库中表的名称。

呼唤.exec()在一个QSqlQuery对象是在数据库上立即执行基于字符串的 SQL 查询的常用方法，但是如果您想预先准备查询以便稍后执行，该怎么办？这是下一节的主题。

执行动态查询：字符串格式化

到目前为止，您已经学习了如何在数据库上执行静态查询。静态查询是那些不接受参数，因此查询按原样运行。尽管这些查询相当有用，但有时您需要创建查询来检索数据以响应某些输入参数。

在执行时接受参数的查询称为动态查询。使用参数允许您微调查询并检索数据以响应特定的参数值。不同的值会产生不同的结果。您可以使用以下两种方法之一在查询中获取输入参数：

1. 动态构建查询，使用字符串格式化插入参数值。
2. 使用占位符参数准备查询，然后将特定值绑定到参数。

第一种方法允许您快速创建动态查询。但是，要安全地使用此方法，您需要确保参数值来自受信任的来源。否则，你可能会面临SQL注入攻击.

以下是如何使用字符串格式在 PyQt 中创建动态查询的示例：

>>> from PyQt5.QtSql import QSqlQuery, QSqlDatabase

>>> con = QSqlDatabase.addDatabase("QSQLITE")
>>> con.setDatabaseName("contacts.sqlite")
>>> con.open()
True

>>> name = "Linda"
>>> job = "Technical Lead"
>>> email = "linda@example.com"

>>> query = QSqlQuery()
>>> query.exec(
...     f"""INSERT INTO contacts (name, job, email)
...     VALUES ('{name}', '{job}', '{email}')"""
... )
True

在此示例中，您使用f 字符串通过将特定值插入基于字符串的 SQL 查询来创建动态查询。最终查询将数据插入到您的contacts表，现在包含有关的数据Linda.

请注意，要使这种动态查询起作用，您需要确保要插入的值具有正确的数据类型。因此，您可以在 f 字符串中的占位符周围使用单引号，因为这些值需要是字符串。

执行动态查询：占位符参数

执行动态查询的第二种方法要求您使用模板预先准备查询占位符对于参数。 PyQt 支持两种参数占位符样式：

1. 甲骨文风格使用命名占位符，例如:name或者:email.
2. ODBC风格使用问号（?) 作为位置占位符。

请注意，这些样式不能在同一查询中混合使用。您可以查看约束值的方法有关如何使用占位符的更多示例。

要在 PyQt 中创建这种动态查询，首先需要为每个查询参数创建一个带有占位符的模板，然后将该模板作为参数传递给.prepare()，它解析、编译并准备查询模板以供执行。如果模板有任何问题，例如 SQL 语法错误，则.prepare()模板编译失败并返回False.

如果准备过程成功，那么prepare()回报True。之后，您可以使用以下命令将特定值传递给每个参数.bindValue()带有命名或位置参数或使用.addBindValue()带有位置参数。.bindValue()有以下两种变体：

1. .bindValue(placeholder, val)
2. .bindValue(pos, val)

在第一个变体中，placeholder代表 Oracle 风格的占位符。在第二个变体中，pos表示一个从零开始的整数以及查询中参数的位置。在这两种变体中，val保存要绑定到特定参数的值。

.addBindValue()使用位置绑定将值添加到占位符列表。这意味着调用的顺序.addBindValue()确定将哪个值绑定到准备好的查询中的每个占位符参数。

要开始使用准备好的查询，您可以准备一个INSERT INTO使用一些示例数据填充数据库的 SQL 语句。返回到您在本节中创建的脚本执行静态 SQL 查询并在调用后添加以下代码print():

28# Creating a query for later execution using .prepare()
29insertDataQuery = QSqlQuery()
30insertDataQuery.prepare(
31    """
32    INSERT INTO contacts (
33        name,
34        job,
35        email
36    )
37    VALUES (?, ?, ?)
38    """
39)
40
41# Sample data
42data = [
43    ("Joe", "Senior Web Developer", "joe@example.com"),
44    ("Lara", "Project Manager", "lara@example.com"),
45    ("David", "Data Analyst", "david@example.com"),
46    ("Jane", "Senior Python Developer", "jane@example.com"),
47]
48
49# Use .addBindValue() to insert data
50for name, job, email in data:
51    insertDataQuery.addBindValue(name)
52    insertDataQuery.addBindValue(job)
53    insertDataQuery.addBindValue(email)
54    insertDataQuery.exec()

第一步是创建一个QSqlQuery目的。然后你打电话.prepare()在查询对象上。在本例中，您使用 ODBC 样式作为占位符。您的查询将获取您联系人的值name, job， 和email，所以您需要三个占位符。自从id列是一个自动递增的整数，您不需要为其提供值。

然后，您创建一些示例数据来填充数据库。data持有一个元组列表，每个元组包含三项：每个联系人的姓名、工作和电子邮件。

最后一步是将要传递的值绑定到每个占位符，然后调用.exec()执行查询。为此，您使用for循环。循环头将每个元组解包在data分成三个独立的变量具有方便的名称。然后你打电话.addBindValue()在查询对象上将值绑定到占位符。

请注意，您正在使用位置占位符，所以你调用的顺序.addBindValue()将定义每个值传递给相应占位符的顺序。

当您想要使用来自用户输入的值自定义查询时，这种创建动态查询的方法非常方便。每当您接受用户输入来完成数据库查询时，您都会面临 SQL 注入的安全风险。

在 PyQt 中，结合.prepare(), .bindValue()， 和.addBindValue()完全保护您免受 SQL 注入攻击，因此当您采用不受信任的输入来完成查询时，可以采用这种方法。

在查询中导航记录

如果你执行一个SELECT声明，然后你的QSqlQuery对象将从数据库中的一个或多个表中检索零个或多个记录。查询将保存包含与查询条件匹配的数据的记录。如果没有数据符合条件，那么您的查询将为空。

QSqlQuery提供了一组导航方式您可以使用它来移动查询结果中的记录：

如果该记录可用，所有这些方法都将查询对象定位在检索到的记录上。这些方法大多都有具体的规则使用它们时适用。使用这些方法，您可以在查询结果中的记录中向前、向后或任意移动。因为他们都返回True或者False，您可以在while 循环一次性浏览所有记录。

这些方法适用于主动查询。成功运行后查询处于活动状态.exec()就可以了，但是查询还没有完成。一旦对有效记录进行活动查询，您就可以使用以下命令从该记录中检索数据.value(索引)。该方法采用从零开始的整数，index，并返回当前记录中该索引（列）处的值。

您将在下面查看一些示例，了解如何使用某些导航方法在查询中移动。但首先，您需要创建与数据库的连接：

>>> from PyQt5.QtSql import QSqlDatabase, QSqlQuery

>>> con = QSqlDatabase.addDatabase("QSQLITE")
>>> con.setDatabaseName("contacts.sqlite")
>>> con.open()
True

在这里，您创建并打开一个新连接contacts.sqlite。如果您到目前为止一直在学习本教程，那么该数据库已经包含一些示例数据。现在您可以创建一个QSqlQuery对象并对该数据执行它：

>>> # Create and execute a query
>>> query = QSqlQuery()
>>> query.exec("SELECT name, job, email FROM contacts")
True

此查询检索有关的数据name, job， 和email存储在的所有联系人中contacts桌子。自从.exec()回True，查询已成功，现在是活动查询。您可以使用之前看到的任何导航方法来导航此查询中的记录。您还可以使用以下方法检索记录中任意列的数据.value():

>>> # First record
>>> query.first()
True

>>> # Named indices for readability
>>> name, job, email = range(3)

>>> # Retrieve data from the first record
>>> query.value(name)
'Linda'

>>> # Next record
>>> query.next()
True
>>> query.value(job)
'Senior Web Developer'

>>> # Last record
>>> query.last()
True
>>> query.value(email)
'jane@example.com'

使用导航方法，您可以在查询结果中移动。和.value()，您可以检索给定记录中任意列的数据。

您还可以使用迭代遍历查询中的所有记录while循环与.next():

>>> query.exec()
True

>>> while query.next():
...     print(query.value(name), query.value(job), query.value(email))
...
Linda Technical Lead linda@example.com
Joe Senior Web Developer joe@example.com
...

和.next()，您可以导航查询结果中的所有记录。.next()工作原理类似于迭代器协议在Python中。迭代查询结果中的记录后，.next()开始返回False直到你跑.exec()再次。致电.exec()从数据库中检索数据并将查询对象的内部指针第一个记录之前的一个位置，所以当你打电话时.next()，您再次获得第一条记录。

您还可以使用相反的顺序循环.previous():

>>> while query.previous():
...     print(query.value(name), query.value(job), query.value(email))
...
Jane Senior Python Developer jane@example.com
David Data Analyst david@example.com
...

.previous()作品类似于.next()，但迭代是以相反的顺序完成的。换句话说，循环从查询指针的位置回到第一条记录。

有时，您可能希望使用该列的名称来获取标识表中给定列的索引。为此，您可以致电.indexOf()的返回值.record():

>>> query.first()
True

>>> # Get the index of name
>>> name = query.record().indexOf("name")

>>> query.value(name)
'Linda'

>>> # Finish the query object if unneeded
>>> query.finish()
>>> query.isActive()
False

致电给.indexOf()的结果.record()返回的索引"name"柱子。如果"name"不存在，那么.indexOf()回报-1。当您使用SELECT *列顺序未知的语句。最后，如果您完成了查询对象，则可以通过调用将其变为非活动状态.finish()。这将释放与当前查询对象关联的系统内存。

了解 PyQt 的模型视图架构

这模型-视图-控制器 (MVC)设计模式是一种通用软件模式，旨在将应用程序的代码分为三个通用层，每个层都有不同的作用。

这模型照顾商业逻辑该应用程序的看法提供屏幕上的表示，并且控制器连接模型和视图以使应用程序正常工作。

Qt 提供了 MVC 的自定义变体。他们称之为模型-视图架构，并且它也适用于 PyQt。该模式还将逻辑分为三个部分：

1. 楷模与数据通信并访问数据。它们还定义了视图和委托用来访问数据的接口。所有模型均基于QA抽象项目模型。一些常用的模型包括QStandardItemModel, QFileSystemModel，以及 SQL 相关模型。

2. 意见负责向用户显示数据。它们也具有与 MVC 模式中的控制器类似的功能。所有观点均基于QAbstractItemView。一些常用的视图是QListView, QTableView， 和QTreeView.

3. 代表们绘制视图项目并提供用于修改项目的编辑器小部件。如果某个项目被修改，他们还会与模型进行通信。基类是QAbstractItemDelegate.

将类分成这三个组件意味着模型上的更改将自动反映在关联的视图或小部件上，并且通过委托对视图或小部件进行的更改将自动更新底层模型。

此外，您可以在不同的视图中显示相同的数据，而不需要多个模型。

使用标准小部件类

PyQt 提供了一堆标准小部件用于在 GUI 应用程序中显示和编辑数据。这些标准小部件提供表格、树和列表等视图。它们还提供用于存储数据的内部容器和方便的代表来编辑数据。所有这些功能都分为一个类。

以下是其中三个标准类：

QTableWidget在显示和编辑数据方面，可以说是最受欢迎的小部件。它创建了一个二维数组QTableWidgetItem对象。每个项目都以字符串形式保存一个单独的值。所有这些值都显示并组织在行和列的表格中。

您至少可以执行以下操作QTableWidget目的：

• 使用委托对象编辑其项目的内容
• 使用添加新项目.setItem()
• 使用设置行数和列数.setRowCount()和.setColumnCount()
• 使用添加垂直和水平标题标签设置水平标题标签()和.setVerticalHeaderLabels

这是一个示例应用程序，展示了如何使用QTableWidget对象在 GUI 中显示数据。该应用程序使用您在前面部分中创建和填充的数据库，因此如果您想运行它，则需要将代码保存到您拥有该应用程序的同一目录中contacts.sqlite数据库：

如果双击表格的任何单元格，则您将能够编辑单元格的内容。但是，您的更改不会保存到数据库中。

这是您的应用程序的代码：

 1import sys
 2
 3from PyQt5.QtSql import QSqlDatabase, QSqlQuery
 4from PyQt5.QtWidgets import (
 5    QApplication,
 6    QMainWindow,
 7    QMessageBox,
 8    QTableWidget,
 9    QTableWidgetItem,
10)
11
12class Contacts(QMainWindow):
13    def __init__(self, parent=None):
14        super().__init__(parent)
15        self.setWindowTitle("QTableView Example")
16        self.resize(450, 250)
17        # Set up the view and load the data
18        self.view = QTableWidget()
19        self.view.setColumnCount(4)
20        self.view.setHorizontalHeaderLabels(["ID", "Name", "Job", "Email"])
21        query = QSqlQuery("SELECT id, name, job, email FROM contacts")
22        while query.next():
23            rows = self.view.rowCount()
24            self.view.setRowCount(rows + 1)
25            self.view.setItem(rows, 0, QTableWidgetItem(str(query.value(0))))
26            self.view.setItem(rows, 1, QTableWidgetItem(query.value(1)))
27            self.view.setItem(rows, 2, QTableWidgetItem(query.value(2)))
28            self.view.setItem(rows, 3, QTableWidgetItem(query.value(3)))
29        self.view.resizeColumnsToContents()
30        self.setCentralWidget(self.view)
31
32def createConnection():
33    con = QSqlDatabase.addDatabase("QSQLITE")
34    con.setDatabaseName("contacts.sqlite")
35    if not con.open():
36        QMessageBox.critical(
37            None,
38            "QTableView Example - Error!",
39            "Database Error: %s" % con.lastError().databaseText(),
40        )
41        return False
42    return True
43
44app = QApplication(sys.argv)
45if not createConnection():
46    sys.exit(1)
47win = Contacts()
48win.show()
49sys.exit(app.exec_())

本示例中发生的情况如下：

• 第 18 至 20 行创建一个QTableWidget对象，将列数设置为4，并为每列标题设置用户友好的标签。
• 21号线创建并执行SELECT对数据库进行 SQL 查询以获取数据库中的所有数据contacts桌子。
• 22号线开始一个while使用循环来导航查询结果中的记录.next().
• 24号线将表中的行数增加1使用.setRowCount().
• 第 25 至 28 行使用以下命令将数据项添加到表中.setItem()。请注意，由于id列是整数，您需要将它们转换为字符串才能将它们存储在QTableWidgetItem目的。

.setItem()采用三个参数：

1. row保存一个从零开始的整数，表示表中给定行的索引。
2. column保存一个从零开始的整数，表示表中给定列的索引。
3. item持有QTableWidgetItem您需要放置在表中给定单元格的对象。

最后，你打电话.resizeColumnsToContents()在您的视图上根据其内容调整列的大小并提供更好的数据呈现。

使用标准小部件显示和编辑数据库表可能成为一项具有挑战性的任务。这是因为您将拥有相同数据的两个副本。换句话说，您将在两个位置拥有数据副本：

1. 在小部件之外，在您的数据库中
2. 在小部件内部，在小部件的内部容器中

您负责手动同步数据的两个副本，这可能是一项烦人且容易出错的操作。幸运的是，您可以使用 PyQt 的模型视图架构来避免大多数此类问题，正如您将在下一节中看到的那样。

使用视图和模型类

PyQt 的模型视图类消除了使用标准小部件类构建数据库应用程序时可能出现的数据重复和同步问题。模型-视图架构允许您使用多个视图来显示相同​​的数据，因为您可以将一个模型传递给多个视图。

模型类提供了应用程序编程接口（API）您可以使用它来操作数据。视图类提供了方便的委托对象，您可以使用它们直接编辑视图中的数据。要将视图与给定模块连接，您需要调用.setModel()在视图对象上。

PyQt 提供了一组支持模型视图架构的视图类：

您可以使用这些视图类和模型类来创建数据库应用程序。这将使您的应用程序更加健壮、编码速度更快并且不易出错。

以下是 PyQt 提供的一些用于处理 SQL 数据库的模型类：

将这些模型之一连接到物理数据库表或查询后，您可以使用它们来填充您的视图。视图提供委托对象，允许您直接在视图中修改数据。连接到视图的模型将更新数据库中的数据以反映视图中的任何更改。请注意，您不必手动更新数据库中的数据。该模型将为您做到这一点。

这是一个示例，展示了如何使用QTableView对象和一个QSqlTableModel对象一起使用 PyQt 的模型-视图架构构建数据库应用程序：

To edit the data in a cell of the table, you can double-click the cell. A convenient delegate widget will show in the cell, allowing you to edit its content. Then you can hit Enter to save the changes.

自动处理和保存数据更改的能力是使用 PyQt 的模型视图类的更重要的优势之一。模型-视图架构将提高您的工作效率并减少您必须自己编写数据操作代码时可能出现的错误。

这是创建应用程序的代码：

 1import sys
 2
 3from PyQt5.QtCore import Qt
 4from PyQt5.QtSql import QSqlDatabase, QSqlTableModel
 5from PyQt5.QtWidgets import (
 6    QApplication,
 7    QMainWindow,
 8    QMessageBox,
 9    QTableView,
10)
11
12class Contacts(QMainWindow):
13    def __init__(self, parent=None):
14        super().__init__(parent)
15        self.setWindowTitle("QTableView Example")
16        self.resize(415, 200)
17        # Set up the model
18        self.model = QSqlTableModel(self)
19        self.model.setTable("contacts")
20        self.model.setEditStrategy(QSqlTableModel.OnFieldChange)
21        self.model.setHeaderData(0, Qt.Horizontal, "ID")
22        self.model.setHeaderData(1, Qt.Horizontal, "Name")
23        self.model.setHeaderData(2, Qt.Horizontal, "Job")
24        self.model.setHeaderData(3, Qt.Horizontal, "Email")
25        self.model.select()
26        # Set up the view
27        self.view = QTableView()
28        self.view.setModel(self.model)
29        self.view.resizeColumnsToContents()
30        self.setCentralWidget(self.view)
31
32def createConnection():
33    con = QSqlDatabase.addDatabase("QSQLITE")
34    con.setDatabaseName("contacts.sqlite")
35    if not con.open():
36        QMessageBox.critical(
37            None,
38            "QTableView Example - Error!",
39            "Database Error: %s" % con.lastError().databaseText(),
40        )
41        return False
42    return True
43
44app = QApplication(sys.argv)
45if not createConnection():
46    sys.exit(1)
47win = Contacts()
48win.show()
49sys.exit(app.exec_())

以下是这段代码中发生的事情：

• 18号线创建一个可编辑的QSqlTableModel目的。
• 19号线将您的模型与contacts数据库中的表使用.setTable().
• 20号线设置编辑策略模型的OnFieldChange。如果用户直接在视图中修改任何数据，此策略允许模型自动更新数据库中的数据。
• 第 21 至 24 行使用以下命令为模型的水平标题设置一些用户友好的标签.setHeaderData().
• 25号线从数据库加载数据并通过调用填充模型.select().
• 27号线创建表视图对象以显示模型中包含的数据。
• 28号线通过调用将视图与模型连接起来.setModel()以您的数据模型作为参数的视图。
• 29号线来电.resizeColumnsToContents()在视图对象上调整表格以适应其内容。

就是这样！您现在拥有一个功能齐全的数据库应用程序。