Создание пользовательского интерфейса для управления данными в Python

Расширенные примеры реализации GUI для БД на PyQt5

Приложение с полным CRUD, поиском и фильтрацией

Используется QSqlTableModel для отображения таблицы сотрудников из SQLite, добавлены поля для поиска по имени и кнопки добавления/удаления строк.

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QTableView, QVBoxLayout, QWidget, QLineEdit, QPushButton, QHBoxLayout, QMessageBox
from PyQt5.QtSql import QSqlDatabase, QSqlTableModel, QSqlQuery
from PyQt5.QtCore import Qt

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('CRUD для сотрудников')
        self.setGeometry(100, 100, 600, 400)
        
        # Подключение к БД
        self.db = QSqlDatabase.addDatabase('QSQLITE')
        self.db.setDatabaseName('employees.db')
        if not self.db.open():
            QMessageBox.critical(self, 'Ошибка', 'Не удалось открыть базу данных')
            sys.exit(1)
        
        # Создание таблицы, если её нет
        query = QSqlQuery()
        query.exec("CREATE TABLE IF NOT EXISTS employees (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, position TEXT, salary REAL)")
        
        # Модель
        self.model = QSqlTableModel(self)
        self.model.setTable('employees')
        self.model.setEditStrategy(QSqlTableModel.OnRowChange)
        self.model.select()
        
        # Основной виджет
        central = QWidget()
        self.setCentralWidget(central)
        layout = QVBoxLayout(central)
        
        # Строка поиска
        search_layout = QHBoxLayout()
        self.search_edit = QLineEdit()
        self.search_edit.setPlaceholderText('Поиск по имени...')
        self.search_edit.textChanged.connect(self.filter_data)
        search_layout.addWidget(self.search_edit)
        layout.addLayout(search_layout)
        
        # Таблица
        self.table = QTableView()
        self.table.setModel(self.model)
        self.table.setSelectionBehavior(QTableView.SelectRows)
        layout.addWidget(self.table)
        
        # Кнопки
        btn_layout = QHBoxLayout()
        add_btn = QPushButton('Добавить строку')
        add_btn.clicked.connect(self.add_row)
        del_btn = QPushButton('Удалить выбранное')
        del_btn.clicked.connect(self.delete_row)
        btn_layout.addWidget(add_btn)
        btn_layout.addWidget(del_btn)
        layout.addLayout(btn_layout)
    
    def filter_data(self, text):
        self.model.setFilter(f"name LIKE '%{text}%'")
        self.model.select()
    
    def add_row(self):
        # Вставляет пустую запись
        row = self.model.rowCount()
        self.model.insertRow(row)
        # Опционально: сразу перейти к редактированию первого поля
        index = self.model.index(row, 1)
        self.table.edit(index)
    
    def delete_row(self):
        selection = self.table.selectionModel().selectedRows()
        for index in sorted(selection, reverse=True):
            self.model.removeRow(index.row())
        self.model.submitAll()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

Результат: открывается окно с таблицей, в строке поиска можно ввести часть имени – таблица фильтруется. Кнопки позволяют добавить пустую строку и удалить выбранные. Изменения автоматически сохраняются при переходе на другую строку (OnRowChange).

Работа с PostgreSQL через QSqlDatabase и параметризация запросов

Пример подключения к удалённой базе PostgreSQL, выборка и вставка данных с защитой от SQL-инъекций.

from PyQt5.QtSql import QSqlDatabase, QSqlQuery

db = QSqlDatabase.addDatabase('QPSQL')
db.setHostName('192.168.1.10')
db.setPort(5432)
db.setDatabaseName('testdb')
db.setUserName('admin')
db.setPassword('secret')
if not db.open():
    print('Ошибка подключения:', db.lastError().text())
else:
    query = QSqlQuery()
    # Параметризованный запрос
    query.prepare('INSERT INTO users (name, age) VALUES (?, ?)')
    query.addBindValue('Иван')
    query.addBindValue(30)
    if not query.exec():
        print('Ошибка вставки:', query.lastError().text())
    else:
        print('Запись добавлена')

Вывод в консоли: "Запись добавлена". Если база недоступна, появится сообщение об ошибке.

Создание отчёта с объединением данных из нескольких таблиц (один ко многим) в QTableView

Использование QSqlQueryModel для выполнения JOIN и отображения результирующего набора.

from PyQt5.QtSql import QSqlDatabase, QSqlQueryModel, QSqlQuery
from PyQt5.QtWidgets import QApplication, QTableView

app = QApplication([])
db = QSqlDatabase.addDatabase('QSQLITE')
db.setDatabaseName(':memory:')  # временная БД для демонстрации
db.open()

# Создание тестовых таблиц
query = QSqlQuery()
query.exec('CREATE TABLE departments (id INTEGER PRIMARY KEY, name TEXT)')
query.exec('INSERT INTO departments VALUES (1, "Продажи"), (2, "Разработка")')
query.exec('CREATE TABLE employees (id INTEGER PRIMARY KEY, name TEXT, dep_id INTEGER REFERENCES departments(id))')
query.exec('INSERT INTO employees VALUES (1, "Анна", 1), (2, "Борис", 2), (3, "Виктор", 1)')

# Модель с JOIN
model = QSqlQueryModel()
model.setQuery('SELECT e.name AS Сотрудник, d.name AS Отдел FROM employees e JOIN departments d ON e.dep_id = d.id')
while model.canFetchMore():
    model.fetchMore()

view = QTableView()
view.setModel(model)
view.show()
app.exec()

В таблице отображаются две колонки: "Сотрудник" и "Отдел" с данными из объединённого запроса. Сортировка по колонкам работает по умолчанию.

Экспорт данных из QTableView в Excel (xlsx) с помощью openpyxl

Дополнение предыдущего примера: кнопка "Экспорт" сохраняет содержимое таблицы в файл Excel.

def export_to_excel(table_view, filepath):
    from openpyxl import Workbook
    wb = Workbook()
    ws = wb.active
    
    model = table_view.model()
    # Заголовки
    for col in range(model.columnCount()):
        header = model.headerData(col, Qt.Horizontal)
        ws.cell(row=1, column=col+1, value=header)
    # Данные
    for row in range(model.rowCount()):
        for col in range(model.columnCount()):
            index = model.index(row, col)
            value = model.data(index)
            ws.cell(row=row+2, column=col+1, value=value)
    wb.save(filepath)
    QMessageBox.information(None, 'Экспорт', f'Данные сохранены в {filepath}')

После нажатия кнопки появляется диалог выбора файла, и таблица сохраняется в формате .xlsx с корректными заголовками.

Асинхронная загрузка данных из БД с использованием QSqlQueryModel и QThread (для больших объёмов)

Чтобы интерфейс не замирал при загрузке миллионов записей, запрос выполняется в отдельном потоке с сигналом для передачи модели.

from PyQt5.QtCore import QThread, pyqtSignal
from PyQt5.QtSql import QSqlQueryModel

class LoaderThread(QThread):
    model_ready = pyqtSignal(QSqlQueryModel)
    
    def run(self):
        model = QSqlQueryModel()
        model.setQuery('SELECT * FROM big_table LIMIT 100000')
        while model.canFetchMore():
            model.fetchMore()
        self.model_ready.emit(model)

# В основном потоке:
# self.loader = LoaderThread()
# self.loader.model_ready.connect(self.on_model_loaded)
# self.loader.start()
# 
# def on_model_loaded(self, model):
#     self.table.setModel(model)

При запуске приложения окно остаётся отзывчивым, а через некоторое время таблица заполняется данными.

Эти примеры демонстрируют гибкость PyQt при создании приложений с базами данных: от простого CRUD до асинхронной загрузки и экспорта. Подобные приёмы применимы и к другим библиотекам после соответствующей адаптации.