Files
mtusi2026lab5/migrations/0004_jobs.sql
T

89 lines
5.2 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.
-- 0004: фоновая обработка вложений (lab5).
-- Только добавляет таблицы/колонки: старая версия API (lab4) с этой схемой работает.
-- Где лежит принятый, но ещё не опубликованный оригинал (приватный prefix staging/).
-- object_key — КОНЕЧНЫЙ ключ originals/<id>: объект там появляется, когда worker его опубликует.
-- После безопасной фиксации результата staging удаляется и колонка обнуляется.
ALTER TABLE attachments ADD COLUMN staging_key text;
ALTER TABLE attachments ADD CONSTRAINT attachments_staging_key_key UNIQUE (staging_key);
-- Одна логическая работа на (вложение, версия pipeline). job_id не меняется при redelivery.
-- attempt — номер управляемой попытки (растёт при retry, lease expiry и replay).
-- lease_token — «забор» (fencing): зафиксировать результат может только владелец
-- текущей аренды; устаревший worker после пробуждения ничего не перезапишет.
CREATE TABLE attachment_jobs (
job_id uuid PRIMARY KEY,
attachment_id uuid NOT NULL REFERENCES attachments (id) ON DELETE CASCADE,
pipeline_version integer NOT NULL,
status text NOT NULL,
attempt integer NOT NULL DEFAULT 1,
max_attempts integer NOT NULL,
lease_token uuid,
lease_owner text,
lease_until timestamptz,
next_attempt_at timestamptz,
error_code text,
last_error text,
replays integer NOT NULL DEFAULT 0,
created_at timestamptz NOT NULL,
updated_at timestamptz NOT NULL,
finished_at timestamptz,
CONSTRAINT attachment_jobs_effect_key UNIQUE (attachment_id, pipeline_version),
CONSTRAINT attachment_jobs_status CHECK (status IN ('queued', 'processing', 'ready', 'failed')),
CONSTRAINT attachment_jobs_attempt CHECK (attempt >= 1 AND attempt <= max_attempts),
CONSTRAINT attachment_jobs_pipeline CHECK (pipeline_version >= 1),
CONSTRAINT attachment_jobs_lease CHECK (status <> 'processing' OR (lease_token IS NOT NULL AND lease_until IS NOT NULL))
);
CREATE INDEX attachment_jobs_lease_idx ON attachment_jobs (lease_until) WHERE status = 'processing';
CREATE INDEX attachment_jobs_failed_idx ON attachment_jobs (finished_at) WHERE status = 'failed';
-- Transactional outbox: строка пишется в ТОЙ ЖЕ транзакции, что вложение и job.
-- Пока published_at IS NULL, relay опубликует её в брокер (повтор безопасен: worker идемпотентен).
-- available_at в будущем — отложенная попытка (backoff с jitter).
CREATE TABLE job_outbox (
id bigserial PRIMARY KEY,
job_id uuid NOT NULL REFERENCES attachment_jobs (job_id) ON DELETE CASCADE,
attempt integer NOT NULL,
payload jsonb NOT NULL,
available_at timestamptz NOT NULL,
created_at timestamptz NOT NULL,
published_at timestamptz,
stream_id text,
publish_attempts integer NOT NULL DEFAULT 0,
last_error text
);
CREATE INDEX job_outbox_pending_idx ON job_outbox (available_at) WHERE published_at IS NULL;
-- Результаты. Ключ эффекта — (attachment_id, pipeline_version, variant):
-- повтор job делает ON CONFLICT DO NOTHING и не создаёт второй набор вариантов.
CREATE TABLE attachment_variants (
attachment_id uuid NOT NULL REFERENCES attachments (id) ON DELETE CASCADE,
pipeline_version integer NOT NULL,
variant text NOT NULL,
object_key text NOT NULL,
content_type text NOT NULL,
width integer NOT NULL,
height integer NOT NULL,
size_bytes bigint NOT NULL,
sha256 text NOT NULL,
created_at timestamptz NOT NULL,
PRIMARY KEY (attachment_id, pipeline_version, variant),
CONSTRAINT attachment_variants_object_key UNIQUE (object_key),
CONSTRAINT attachment_variants_name CHECK (variant IN ('thumbnail', 'crop', 'optimized')),
CONSTRAINT attachment_variants_type CHECK (content_type IN ('image/jpeg', 'image/png', 'image/webp')),
CONSTRAINT attachment_variants_dims CHECK (width > 0 AND height > 0 AND size_bytes > 0),
CONSTRAINT attachment_variants_sha256 CHECK (sha256 ~ '^[a-f0-9]{64}$')
);
-- Журнал событий job: реестр для оператора (failed, replay, takeover) без секретов.
CREATE TABLE job_events (
id bigserial PRIMARY KEY,
job_id uuid NOT NULL REFERENCES attachment_jobs (job_id) ON DELETE CASCADE,
at timestamptz NOT NULL DEFAULT now(),
event text NOT NULL,
attempt integer,
actor text,
detail text
);
CREATE INDEX job_events_job_idx ON job_events (job_id, id);