ddadminandClaude Opus 5
1e8b83ffbb
Зачем: - Дать слою первую физическую сущность и показать идемпотентность, устроенную иначе, чем в приёме: заменой партиции, а не колонкой версии. - Родить механику дневной пересборки на кластере — образец для сессий и витрин. Что: - Добавлены dds.order_rep/_dist, двойник-донор dds.order_stage_rep/_dist и публичный договор dds.order_v с разбором позиций в три массива. - Добавлены запросы объёма прогона, сборки в двойник и замены партиции по дню. - Добавлен даг dds_transform: группа задач order, замена — размноженной задачей. - Окно изменяемости K пришло на сторону стенда якорем compose; владелец числа остаётся у генератора. - Объём считается от позднейшего дня заказа и первого недостающего дня: ярлыки доставки ODS для этого непригодны, а максимум собранного дня прячет дыры. - Записано, чего конвейер о себе не знает, и адресовано контуру DQ. Проверка: - make lint - make smoke, make check-clickhouse, make check-services - Прогон по стартовому миру: 1917 заказов, счёт равен ods.order_v, каждый заказ на шарде своего cityHash64(order_id), сумма позиций равна items_total. - Повтор без нового слепка: содержимое то же, _load_id новый; после слепка пересобрано окно, день за окном не тронут. - Снесённая руками партиция 2026-06-01 восстановлена побайтово. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
29 lines
2.6 KiB
SQL
29 lines
2.6 KiB
SQL
-- DDS: подмена одного дня заказов собранной партицией двойника.
|
|
--
|
|
-- Это и есть идемпотентность слоя. Повтор прогона безопасен, а «дыхание»
|
|
-- статусов внутри окна выражается сменой всей партиции, а не правкой строк.
|
|
--
|
|
-- Замена идёт по локальным таблицам, шард за шардом: ON CLUSTER рассылает её
|
|
-- на обе ноды, а по Distributed то же самое не работает — операции с
|
|
-- партициями отвечают кодом 48 (docs/architecture/storage.md, «Что
|
|
-- проверено»). Правильность пошардовой замены держится на том, что двойник
|
|
-- шардирован тем же ключом, что цель, — см. sql/ddl/45-dds-tables.sql.
|
|
--
|
|
-- Отсюда граница обещания: атомарность здесь пошардовая. Внутри шарда подмена
|
|
-- мгновенна — читатель видит либо прежний день целиком, либо новый; но две
|
|
-- локальные замены независимы, и в зазоре между ними чтение через Distributed
|
|
-- соберёт ответ из нового дня одного шарда и прежнего дня другого. Зазор
|
|
-- короткий, а отказ одной из двух замен растягивает его до повторного прогона.
|
|
--
|
|
-- Пустая партиция двойника — законный случай, а не сбой: день, в котором
|
|
-- заказов нет, снимает день из цели, и слой перестаёт показывать то, чего в
|
|
-- источнике больше нет.
|
|
--
|
|
-- День подставляет Jinja, а не параметр ClickHouse: в ALTER … PARTITION
|
|
-- сервер параметров не подставляет — замерено, отвечает синтаксической
|
|
-- ошибкой. Общее правило репозитория «параметры передаются отдельно, а не
|
|
-- строкой» здесь не нарушено по существу: значение пришло из ответа самого
|
|
-- ClickHouse на запрос объёма, а не снаружи стенда.
|
|
ALTER TABLE dds.order_rep ON CLUSTER clickstream_cluster
|
|
REPLACE PARTITION '{{ params.day }}' FROM dds.order_stage_rep;
|