220 lines
5.9 KiB
SQL
220 lines
5.9 KiB
SQL
-- Расширение метаданных вложения для асинхронной обработки.
|
|
|
|
ALTER TABLE attachments
|
|
DROP CONSTRAINT chk_attachment_status;
|
|
|
|
ALTER TABLE attachments
|
|
ADD CONSTRAINT chk_attachment_status
|
|
CHECK (
|
|
status IN (
|
|
'queued',
|
|
'processing',
|
|
'ready',
|
|
'failed'
|
|
)
|
|
);
|
|
|
|
ALTER TABLE attachments
|
|
ADD COLUMN staging_key TEXT,
|
|
ADD COLUMN pipeline_version INTEGER NOT NULL DEFAULT 1,
|
|
ADD COLUMN error_code VARCHAR(64);
|
|
|
|
ALTER TABLE attachments
|
|
ADD CONSTRAINT uq_attachment_staging_key
|
|
UNIQUE (staging_key),
|
|
|
|
ADD CONSTRAINT chk_attachment_pipeline_version
|
|
CHECK (pipeline_version >= 1),
|
|
|
|
ADD CONSTRAINT chk_attachment_error
|
|
CHECK (
|
|
(
|
|
status = 'failed'
|
|
AND error_code IS NOT NULL
|
|
AND length(error_code) > 0
|
|
)
|
|
OR
|
|
(
|
|
status <> 'failed'
|
|
AND error_code IS NULL
|
|
)
|
|
);
|
|
|
|
CREATE INDEX idx_attachments_status
|
|
ON attachments(status, updated_at);
|
|
|
|
|
|
-- Готовые варианты изображения.
|
|
-- object_key используется внутри приложения и не выдаётся клиенту.
|
|
-- Ключ эффекта соответствует контракту:
|
|
-- attachment_id + pipeline_version + variant.
|
|
|
|
CREATE TABLE attachment_variants (
|
|
attachment_id UUID NOT NULL
|
|
REFERENCES attachments(id) ON DELETE CASCADE,
|
|
|
|
pipeline_version INTEGER NOT NULL,
|
|
name VARCHAR(32) NOT NULL,
|
|
|
|
object_key TEXT NOT NULL UNIQUE,
|
|
content_type VARCHAR(32) NOT NULL,
|
|
|
|
size_bytes BIGINT NOT NULL,
|
|
width INTEGER NOT NULL,
|
|
height INTEGER NOT NULL,
|
|
sha256 CHAR(64) NOT NULL,
|
|
|
|
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
|
|
PRIMARY KEY (
|
|
attachment_id,
|
|
pipeline_version,
|
|
name
|
|
),
|
|
|
|
CONSTRAINT chk_variant_pipeline_version
|
|
CHECK (pipeline_version >= 1),
|
|
|
|
CONSTRAINT chk_variant_name
|
|
CHECK (
|
|
name IN (
|
|
'thumbnail',
|
|
'crop',
|
|
'optimized'
|
|
)
|
|
),
|
|
|
|
CONSTRAINT chk_variant_content_type
|
|
CHECK (
|
|
content_type IN (
|
|
'image/jpeg',
|
|
'image/png',
|
|
'image/webp'
|
|
)
|
|
),
|
|
|
|
CONSTRAINT chk_variant_size
|
|
CHECK (size_bytes > 0),
|
|
|
|
CONSTRAINT chk_variant_dimensions
|
|
CHECK (width > 0 AND height > 0),
|
|
|
|
CONSTRAINT chk_variant_sha256
|
|
CHECK (sha256 ~ '^[a-f0-9]{64}$')
|
|
);
|
|
|
|
|
|
-- Одна логическая работа над вложением в рамках версии pipeline.
|
|
-- job_id не меняется при повторной доставке.
|
|
-- attempts увеличивается при начале управляемой попытки,
|
|
-- а не при каждом получении дубликата сообщения.
|
|
|
|
CREATE TABLE attachment_jobs (
|
|
id UUID PRIMARY KEY,
|
|
|
|
attachment_id UUID NOT NULL
|
|
REFERENCES attachments(id) ON DELETE CASCADE,
|
|
|
|
pipeline_version INTEGER NOT NULL DEFAULT 1,
|
|
|
|
status VARCHAR(16) NOT NULL DEFAULT 'queued',
|
|
|
|
attempts INTEGER NOT NULL DEFAULT 0,
|
|
max_attempts INTEGER NOT NULL DEFAULT 3,
|
|
|
|
available_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
|
|
lease_owner UUID,
|
|
lease_until TIMESTAMPTZ,
|
|
|
|
last_error_code VARCHAR(64),
|
|
|
|
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
|
|
CONSTRAINT uq_attachment_job_pipeline
|
|
UNIQUE (
|
|
attachment_id,
|
|
pipeline_version
|
|
),
|
|
|
|
CONSTRAINT chk_job_pipeline_version
|
|
CHECK (pipeline_version >= 1),
|
|
|
|
CONSTRAINT chk_job_status
|
|
CHECK (
|
|
status IN (
|
|
'queued',
|
|
'processing',
|
|
'ready',
|
|
'failed'
|
|
)
|
|
),
|
|
|
|
CONSTRAINT chk_job_attempts
|
|
CHECK (
|
|
max_attempts >= 1
|
|
AND attempts >= 0
|
|
AND attempts <= max_attempts
|
|
),
|
|
|
|
CONSTRAINT chk_job_lease
|
|
CHECK (
|
|
(
|
|
status = 'processing'
|
|
AND lease_owner IS NOT NULL
|
|
AND lease_until IS NOT NULL
|
|
)
|
|
OR
|
|
(
|
|
status <> 'processing'
|
|
AND lease_owner IS NULL
|
|
AND lease_until IS NULL
|
|
)
|
|
)
|
|
);
|
|
|
|
CREATE INDEX idx_attachment_jobs_available
|
|
ON attachment_jobs(available_at, id)
|
|
WHERE status = 'queued';
|
|
|
|
CREATE INDEX idx_attachment_jobs_expired_lease
|
|
ON attachment_jobs(lease_until, id)
|
|
WHERE status = 'processing';
|
|
|
|
|
|
-- Намерение публикации задания в брокер.
|
|
-- Записывается в той же транзакции, что и метаданные задания.
|
|
-- published_at устанавливается после подтверждения брокера.
|
|
-- Потеря подтверждения может привести к повторной публикации:
|
|
-- worker обязан обрабатывать её идемпотентно.
|
|
|
|
CREATE TABLE attachment_outbox (
|
|
id UUID PRIMARY KEY,
|
|
|
|
job_id UUID NOT NULL
|
|
REFERENCES attachment_jobs(id) ON DELETE CASCADE,
|
|
|
|
attempt INTEGER NOT NULL,
|
|
|
|
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
next_publish_at TIMESTAMPTZ NOT NULL DEFAULT now(),
|
|
|
|
published_at TIMESTAMPTZ,
|
|
|
|
publish_attempts INTEGER NOT NULL DEFAULT 0,
|
|
last_error_code VARCHAR(64),
|
|
|
|
CONSTRAINT uq_attachment_outbox_attempt
|
|
UNIQUE (job_id, attempt),
|
|
|
|
CONSTRAINT chk_outbox_attempt
|
|
CHECK (attempt >= 1),
|
|
|
|
CONSTRAINT chk_outbox_publish_attempts
|
|
CHECK (publish_attempts >= 0)
|
|
);
|
|
|
|
CREATE INDEX idx_attachment_outbox_pending
|
|
ON attachment_outbox(next_publish_at, id)
|
|
WHERE published_at IS NULL; |