3.8 KiB
Lab3: общая идемпотентность и транзакции
Основа — собственная lab2. PostgreSQL остаётся источником истины пользователей, чатов, членства, сообщений и сессий. Valkey — восстанавливаемый кэш User, а не доказательство действительности Bearer. У API нет обязательного локального состояния. Каждому процессу при старте назначается случайный X-Instance-Id.
Новая миграция добавляет message_requests. Область ключа: user_id + HTTP method POST + chat_id (путь коллекции сообщений) + ASCII key. PK обеспечивает точную уникальность области; payload_hash содержит SHA-256 канонического валидированного тела. response_message_id ссылается на неизменяемое Message. Срок хранения результата не менее 86400 секунд, часы — PostgreSQL.
Отправка под READ COMMITTED:
- Аутентификация и проверка членства выполняются заново, включая повтор.
- Transaction-level advisory lock сериализует одну область между процессами. 64-битный hash используется только как lock: коллизия вызывает лишнее ожидание, но не подменяет точный PK и сравнение payload_hash.
- Неистёкший результат с тем же body возвращает прежнее Message/201; другой body даёт 409. Истёкшую запись ключа можно заменить, старое Message остаётся.
- INSERT Message и INSERT результата идут в одной транзакции. HTTP 201 выдаётся после COMMIT. Ошибка между вставками откатывает обе; 5xx не запоминаются.
Канонизация сохраняет точный text, сортирует JSON-ключи и учитывает пустой список вложений для последующего расширения. Внешняя схема lab3 по OpenAPI пока принимает только text; поля будущих лабораторных не включаются в обязательный контракт.
Миграции исполняет отдельный migrate service под advisory lock; API не запускают DDL. Миграция 002 только добавляет таблицу и индексы: она совместима с lab2, но старый API не умеет обязательную идемпотентность, поэтому его нельзя смешивать с lab3 за одним LB. Внутри lab3 поочерёдная замена процесса не меняет схему.
Исследуемая оптимизация: одиночные SELECT выполняются в autocommit, без отдельных сетевых команд BEGIN/COMMIT. PostgreSQL по-прежнему исполняет каждый SELECT в транзакции. Вставки, отзыв сессии, многокомандное создание чата и идемпотентная отправка всегда используют явную транзакцию и COMMIT до ответа. DATABASE_READ_AUTOCOMMIT=0 включает базовый вариант с явными транзакциями и для чтения; =1 — оптимизацию. Уровень изоляции, SQL, пул и обработчики одинаковы.