如何使用 PyQt6 和 qt_material 库,打造一个功能完善的 SQLite 数据库管理工具,轻松管理和查询 SQLite 数据库。
一、目标
- 数据库连接与表管理:支持连接 SQLite 数据库,显示数据库中的表,并允许用户选择表进行操作。
- 表数据分页显示:支持分页显示表数据,方便用户浏览大量数据。
- 字段信息展示:点击表数据中的字段,展示字段的详细信息。
- SQL 查询与结果展示:允许用户输入 SQL 查询语句,并在界面中展示查询结果。
- 界面美化:使用 qt_material 库,为工具提供美观的界面。
二、技术选型
- PyQt6:用于构建图形用户界面(GUI)。PyQt6 是一个功能强大的库,支持快速开发跨平台的桌面应用程序。
- qt_material:用于美化界面。qt_material 提供了丰富的主题和样式,让界面更加美观。
- SQLite3:作为数据库引擎,用于连接和操作 SQLite 数据库。
三、功能实现与代码优化
以下是实现上述功能的代码实现和优化过程。
1. 初始化界面
初始化主界面,包括数据库选择按钮、表选择下拉框、表数据展示区域、字段信息展示区域和 SQL 查询区域。
def init_ui(self):
"""
初始化界面布局和组件
"""
# 主布局
main_layout = QVBoxLayout()
main_widget = QWidget()
main_widget.setLayout(main_layout)
self.setCentralWidget(main_widget)
# 操作栏
self.toolbar = QHBoxLayout()
main_layout.addLayout(self.toolbar)
# 数据库选择按钮
self.open_db_button = QPushButton("选择数据库")
self.open_db_button.clicked.connect(self.open_database) # 绑定选择数据库的槽函数
self.toolbar.addWidget(self.open_db_button)
# 当前数据库和表信息
self.db_info_label = QLabel("未选择数据库")
self.toolbar.addWidget(self.db_info_label)
# 下部分:左右布局
self.lower_layout = QHBoxLayout()
main_layout.addLayout(self.lower_layout)
# 左侧:表选择和表信息
self.left_layout = QVBoxLayout()
self.left_widget = QWidget()
self.left_widget.setLayout(self.left_layout)
self.lower_layout.addWidget(self.left_widget)
# 表选择下拉框
self.table_combo = QComboBox()
self.table_combo.currentTextChanged.connect(self.load_table_info) # 绑定加载表信息的槽函数
self.left_layout.addWidget(self.table_combo)
# 设置 QComboBox 的样式
self.table_combo.setStyleSheet("""
QComboBox {
color: white; /* 设置默认文本颜色为白色 */
background-color: black; /* 设置背景颜色为黑色 */
}
QComboBox::item:selected {
background-color: white; /* 设置选中项的背景颜色为白色 */
color: black; /* 设置选中项的文本颜色为黑色 */
}
QComboBox::item {
background-color: black; /* 设置下拉菜单项的背景颜色为黑色 */
color: white; /* 设置下拉菜单项的文本颜色为白色 */
}
""")
# 左侧:表数据展示(分页)
self.table_data_table = QTableWidget()
self.table_data_table.setEditTriggers(QAbstractItemView.EditTrigger.NoEditTriggers) # 设置表格为只读
self.table_data_table.itemClicked.connect(self.show_field_info) # 绑定点击表格项的槽函数
self.table_data_table.horizontalHeader().setSectionResizeMode(QHeaderView.ResizeMode.Interactive) # 列宽可手动调整
self.left_layout.addWidget(self.table_data_table)
# 分页布局
self.pagination_layout = QHBoxLayout()
self.pagination_layout.setAlignment(Qt.AlignmentFlag.AlignCenter) # 居中对齐
self.left_layout.addLayout(self.pagination_layout)
self.prev_button = QPushButton("上一页")
self.prev_button.clicked.connect(self.prev_page) # 绑定上一页的槽函数
self.pagination_layout.addWidget(self.prev_button)
self.page_label = QLabel("1/1")
self.pagination_layout.addWidget(self.page_label)
self.next_button = QPushButton("下一页")
self.next_button.clicked.connect(self.next_page) # 绑定下一页的槽函数
self.pagination_layout.addWidget(self.next_button)
# 右侧:字段信息和 SQL 执行
self.right_layout = QVBoxLayout()
self.right_widget = QWidget()
self.right_widget.setLayout(self.right_layout)
self.lower_layout.addWidget(self.right_widget)
# 右侧上部分:字段信息展示区域
self.field_info_area = QTextEdit()
self.field_info_area.setReadOnly(True) # 设置为只读
self.field_info_area.setPlaceholderText("点击字段以显示详细信息")
self.right_layout.addWidget(self.field_info_area)
# 右侧下部分:SQL 执行
self.sql_layout = QVBoxLayout()
self.sql_widget = QWidget()
self.sql_widget.setLayout(self.sql_layout)
self.right_layout.addWidget(self.sql_widget)
self.sql_text = QTextEdit()
self.sql_layout.addWidget(self.sql_text)
self.execute_button = QPushButton("执行 SQL")
self.execute_button.clicked.connect(self.execute_sql) # 绑定执行 SQL 的槽函数
self.sql_layout.addWidget(self.execute_button)
# 设置右侧区域的高度比例(字段信息:SQL 区域 = 4:1)
self.right_layout.setStretchFactor(self.field_info_area, 4)
self.right_layout.setStretchFactor(self.sql_widget, 1)
2. 数据库连接与表管理
用户可以通过点击“选择数据库”按钮,选择一个 SQLite 数据库文件。程序会连接到数据库,并加载数据库中的表名到下拉框中。
def open_database(self):
"""
打开 SQLite 数据库文件
"""
db_path, _ = QFileDialog.getOpenFileName(self, "选择 SQLite 数据库", "", "SQLite Database (*.db *.sqlite)")
if db_path:
self.connection = sqlite3.connect(db_path)
self.cursor = self.connection.cursor()
self.cursor.execute("SELECT name FROM sqlite_master WHERE type='table';")
tables = [table[0] for table in self.cursor.fetchall()]
self.table_combo.clear()
self.table_combo.addItems(tables)
self.db_info_label.setText(f"数据库:{db_path}")
self.current_table = None
3. 表数据分页显示
用户可以选择一个表,程序会分页显示表中的数据。可以通过“上一页”和“下一页”按钮浏览不同页的数据。
def load_table_page(self):
"""
加载表数据的当前分页内容
"""
if not self.current_table:
return
try:
self.cursor.execute(f"SELECT * FROM {self.current_table}")
all_rows = self.cursor.fetchall()
self.total_pages = (len(all_rows) + self.page_size - 1) // self.page_size
start_index = (self.current_page - 1) * self.page_size
end_index = start_index + self.page_size
rows = all_rows[start_index:end_index]
self.cursor.execute(f"PRAGMA table_info({self.current_table})")
columns = [col[1] for col in self.cursor.fetchall()]
self.table_data_table.setRowCount(len(rows))
self.table_data_table.setColumnCount(len(columns))
self.table_data_table.setHorizontalHeaderLabels(columns)
for i, row in enumerate(rows):
for j, value in enumerate(row):
self.table_data_table.setItem(i, j, QTableWidgetItem(str(value)))
self.page_label.setText(f"{self.current_page}/{self.total_pages}")
except Exception as e:
QMessageBox.warning(self, "错误", f"加载表数据失败:{e}")
4. 字段信息展示
可以点击表数据中的字段,程序会在右侧的字段信息区域展示字段的详细信息。
def show_field_info(self, item):
"""
显示字段信息
"""
field_value = item.text()
field_name = self.table_data_table.horizontalHeaderItem(item.column()).text()
self.field_info_area.setText(f"字段名:{field_name}\n字段值:{field_value}")
5. SQL 查询与结果展示
在右侧的 SQL 输入框中输入 SQL 查询语句,点击“执行 SQL”按钮后,程序会在左侧的表格中展示查询结果。
def execute_sql(self):
"""
执行 SQL 查询
"""
sql = self.sql_text.toPlainText()
try:
self.cursor.execute(sql)
self.connection.commit()
# 获取查询结果
rows = self.cursor.fetchall()
columns = [desc[0] for desc in self.cursor.description] if self.cursor.description else []
# 更新左侧表格以显示查询结果
self.update_table_data(rows, columns)
QMessageBox.information(self, "成功", "SQL 执行成功")
except Exception as e:
QMessageBox.warning(self, "失败", f"SQL 执行失败:{e}")
def update_table_data(self, rows, columns):
"""
更新左侧表格以显示查询结果
"""
self.table_data_table.setRowCount(len(rows))
self.table_data_table.setColumnCount(len(columns))
self.table_data_table.setHorizontalHeaderLabels(columns)
for i, row in enumerate(rows):
for j, value in enumerate(row):
self.table_data_table.setItem(i, j, QTableWidgetItem(str(value)))
四、界面美化
qt_material 提供了丰富的主题和样式。
if __name__ == "__main__":
app = QApplication(sys.argv)
apply_stylesheet(app, theme="dark_teal.xml") # 使用 dark_teal 主题
window = SQLiteManager()
window.show()
sys.exit(app.exec())