🔌 Доступ к базе из Python

Короткий ответ psycopg2 — синхронный драйвер, каждый вызов блокирует текущий поток/процесс до получения ответа от БД, а asyncpg — асинхронный драйвер, работающий через event loop asyncio и позволяющий не блокировать поток на время ожидания ответа от сети/БД. Как это работает подробнее psycopg2 выполняет сетевой I/O синхронно, поэтому внутри асинхронного приложения (например, FastAPI с async def) вызов psycopg2 заблокирует весь event loop, если не выполнить его в отдельном потоке. asyncpg встраивается в event loop через await, уступая управление другим задачам на время ожидания сети. Пример кода Что использовать на практике Практика. Для асинхронных фреймворков (FastAPI, aiohttp) выбирают asyncpg или async-обёртки SQLAlchemy/Django ORM; для классических WSGI-приложений (Flask, обычный Django) psycopg2 остаётся стандартным выбором. Подводные камни Ошибка. Вызывают синхронный psycopg2 напрямую внутри async def обработчика без выноса в threadpool, убирая выигрыш от асинхронности — один медленный запрос блокирует

Читать полностьюasyncpg

Короткий ответ Тест запускают на изолированной тестовой БД, каждый тест оборачивают в транзакцию, которая откатывается после теста, чтобы тесты не влияли друг на друга. Как это работает подробнее Django предоставляет класс TestCase, который оборачивает каждый тест в транзакцию и делает ROLLBACK в конце; для SQLAlchemy аналогичный паттерн реализуют вручную через фикстуры pytest, открывающие транзакцию на тестовую БД. Пример кода Что использовать на практике Практика. Тестовую БД настраивают через отдельные переменные окружения/настройки, отличные от production, и никогда не указывают реальный production DSN в тестовом окружении. Подводные камни Ошибка. Используют один и тот же экземпляр БД для тестов и разработки без изоляции транзакций, из-за чего тесты влияют друг на друга; мокают слишком много уровней БД, из-за чего тест не проверяет реальное SQL-поведение (например, constraint).

Читать полностьюdatabase-access

Короткий ответ Ошибку нужно перехватывать явным except на конкретный тип исключения (например, IntegrityError в Django/SQLAlchemy), откатывать текущую транзакцию и возвращать понятный ответ или бизнес-исключение, а не «проглатывать» любое исключение широким except. Как это работает подробнее При нарушении constraint СУБД отклоняет операцию и возвращает ошибку с конкретным кодом (например, SQLSTATE 23505 для unique_violation в PostgreSQL), которую драйвер оборачивает в своё исключение; транзакция переходит в состояние «aborted» до ROLLBACK. Пример кода Что использовать на практике Практика. В веб-приложении типичный паттерн — перехватить конкретное исключение и преобразовать его в понятный ответ пользователю (например, HTTP 409 Conflict «email уже занят»), вместо падения с 500 ошибкой. Подводные камни Ошибка. Ловят голый except Exception и просто логируют, теряя возможность вернуть осмысленный ответ; не делают rollback после перехваченной ошибки, получая новую ошибку «current transaction is aborted» на следующ

Читать полностьюdatabase-access

Короткий ответ DSN (connection string) — это строка, описывающая все параметры подключения к БД: драйвер, пользователя, пароль, хост, порт, имя базы и дополнительные опции (например, SSL-режим), которую используют драйверы и ORM для установления соединения. Как это работает подробнее Формат URL обычно выглядит как postgresql://user:password@host:port/dbname?param=value; ORM и драйверы парсят эту строку, чтобы получить все данные для TCP-соединения и аутентификации. Пример кода Что использовать на практике Практика. Секреты (пароль) нельзя хранить в коде или в системе контроля версий — их передают через переменные окружения или секрет-хранилище (Vault, AWS Secrets Manager), а в коде собирают DSN динамически. Подводные камни Ошибка. Хардкодят пароль прямо в строке подключения в репозитории; не указывают sslmode=require в production, что может оставить трафик к БД незашифрованным при подключении через внешнюю сеть.

Читать полностьюdatabase-access