41 lines
2.8 KiB
SQL
41 lines
2.8 KiB
SQL
-- 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);
|