Files
mtusi2026lab3/migrations/004_message_idempotency.sql
T
2026-10-15 00:24:46 +03:00

31 lines
2.5 KiB
SQL

-- 004 (lab3): идемпотентность отправки сообщения (заголовок Idempotency-Key).
--
-- Ключ и SHA-256 тела запроса хранятся прямо в строке сообщения. Уникальное ограничение
-- (chat_id, sender_id, idempotency_key) = область ключа из контракта: пользователь + чат
-- (метод и путь у этого ключа всегда POST /chats/{id}/messages). Повтор с тем же ключом
-- не может создать второе сообщение даже при одновременных запросах через разные реплики.
-- Ключ живёт столько же, сколько сообщение (бессрочно; контракт требует не меньше 24 ч).
--
-- Совместимость с уже работающей версией (lab2): добавляются только НОВЫЕ столбцы,
-- которые могут быть NULL. Старый код пишет сообщения без ключа (NULL) и читает только
-- свои столбцы — он продолжает работать с новой схемой. Строки без ключа уникальность
-- не нарушают: в PostgreSQL значения NULL не считаются одинаковыми.
-- Ограничение: на большой таблице построение уникального индекса блокирует запись в messages.
-- Для большой базы индекс строят заранее через CREATE UNIQUE INDEX CONCURRENTLY (вне транзакции),
-- а затем добавляют ограничение USING INDEX. На учебной базе это доли секунды.
ALTER TABLE messages
ADD COLUMN idempotency_key text,
ADD COLUMN request_hash bytea;
ALTER TABLE messages
ADD CONSTRAINT messages_idempotency_key_format
CHECK (idempotency_key ~ '^[A-Za-z0-9._:-]{1,128}$'),
ADD CONSTRAINT messages_request_hash_len
CHECK (octet_length(request_hash) = 32),
-- ключ и отпечаток тела всегда вместе: оба заданы или оба NULL
ADD CONSTRAINT messages_key_with_hash
CHECK ((idempotency_key IS NULL) = (request_hash IS NULL)),
ADD CONSTRAINT messages_idempotency_unique
UNIQUE (chat_id, sender_id, idempotency_key);