forked from mtusi2026/mtusi2026lab5
89 lines
5.2 KiB
SQL
89 lines
5.2 KiB
SQL
-- 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);
|