Files
mtusi2026lab6/migrations/003_idempotency_keys.sql
T

41 lines
2.8 KiB
SQL
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
-- 003 (lab3): общая идемпотентность POST /chats/{chat_id}/messages.
--
-- Область уникальности по контракту: пользователь + HTTP-метод + путь чата + ключ.
-- Путь однозначно задаётся chat_id, метод сейчас всегда POST (колонка оставлена,
-- чтобы область ключа была записана явно и расширялась без смены PK).
--
-- Атомарность: строка ключа и сообщение пишутся ОДНОЙ транзакцией.
-- 1. INSERT ключа (ON CONFLICT ...) — конкурентный повтор с тем же ключом
-- ждёт на уникальном индексе, пока первая транзакция не завершится;
-- 2. INSERT сообщения с заранее выбранным id;
-- 3. COMMIT. FK message_id -> messages проверяется в момент COMMIT
-- (DEFERRABLE INITIALLY DEFERRED), поэтому message_id NOT NULL с первого шага.
-- Ошибка/откат на любом шаге не оставляет ни сообщения, ни ключа:
-- транзиентный 5xx не фиксируется как окончательный результат.
--
-- Совместимость с работающей версией (rolling update): миграция только
-- добавляет новую таблицу, старые таблицы и запросы не меняются.
CREATE TABLE idempotency_keys (
user_id uuid NOT NULL REFERENCES users (id) ON DELETE CASCADE,
method text NOT NULL DEFAULT 'POST',
chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE,
idem_key text NOT NULL,
request_hash bytea NOT NULL,
message_id uuid NOT NULL
REFERENCES messages (id) ON DELETE CASCADE
DEFERRABLE INITIALLY DEFERRED,
created_at timestamptz NOT NULL DEFAULT clock_timestamp(),
expires_at timestamptz NOT NULL,
PRIMARY KEY (user_id, method, chat_id, idem_key),
CONSTRAINT idempotency_keys_key_format CHECK (idem_key ~ '^[A-Za-z0-9._:-]{1,128}$'),
CONSTRAINT idempotency_keys_method CHECK (method IN ('POST')),
CONSTRAINT idempotency_keys_hash_len CHECK (octet_length(request_hash) = 32),
CONSTRAINT idempotency_keys_expiry_after_create CHECK (expires_at > created_at)
);
-- Периодическая очистка истёкших ключей (src/idempotency.py).
CREATE INDEX idempotency_keys_expires_at_idx ON idempotency_keys (expires_at);
-- ON DELETE CASCADE от messages без полного скана.
CREATE INDEX idempotency_keys_message_id_idx ON idempotency_keys (message_id);