Files
clickstream-data-platform/sql/ddl/50-dds-views.sql
T
ddadminandClaude Opus 5 1e8b83ffbb feat(dds): добавлена модель заказа и пересборка окна заменой партиций
Зачем:
- Дать слою первую физическую сущность и показать идемпотентность, устроенную
  иначе, чем в приёме: заменой партиции, а не колонкой версии.
- Родить механику дневной пересборки на кластере — образец для сессий и витрин.

Что:
- Добавлены 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>
2026-08-26 05:20:39 -04:00

102 lines
4.3 KiB
SQL

-- DDS: публичный договор события на языке бизнес-модели.
--
-- Событие не копируется в DDS: обычное представление вторым уровнем читает
-- точное состояние из ods.event_v. Явный список колонок не пропускает в
-- договор служебные и сырые поля ODS при будущих изменениях источника.
--
-- Представление — договор чтения, не граница прав: роль bi_reader читает его
-- источник по решению docs/adr/0007-clickhouse-access.md.
--
-- event_date берётся напрямую из EventDate. Пересчёт из event_time помешал бы
-- первичному индексу отбирать день до чтения.
--
-- Europe/Samara задаёт пояс счётчика модельного мира. DDS отдаёт event_time
-- в этой временной линзе.
CREATE VIEW IF NOT EXISTS dds.event_v ON CLUSTER clickstream_cluster
AS
SELECT
WatchID AS event_id,
ClientID AS client_id,
CounterID AS counter_id,
EventDate AS event_date,
toTimeZone(UTCEventTime, 'Europe/Samara') AS event_time,
ClientTimeZone AS client_timezone,
EventType AS event_type,
URL AS url,
Referer AS referer,
Title AS title,
UTMSource AS utm_source,
UTMMedium AS utm_medium,
UTMCampaign AS utm_campaign,
UTMContent AS utm_content,
UTMTerm AS utm_term,
LastTrafficSource AS last_traffic_source,
HasGCLID AS has_gclid,
YCLID AS yclid,
Browser AS browser,
BrowserMajorVersion AS browser_major_version,
BrowserLanguage AS browser_language,
OperatingSystem AS operating_system,
OperatingSystemRoot AS operating_system_root,
transform(
DeviceCategory,
[1, 2, 3, 4],
['desktop', 'mobile', 'tablet', 'tv'],
toString(DeviceCategory)
) AS device_category,
MobilePhoneModel AS mobile_phone_model,
ScreenWidth AS screen_width,
ScreenHeight AS screen_height,
IPAddress AS ip_address,
RegionCountry AS region_country,
RegionCity AS region_city,
RegionCountryID AS region_country_id,
RegionCityID AS region_city_id,
GoalsReached AS goals_reached,
ParsedParamsKey1 AS parsed_params_key1,
purchaseID AS purchase_id,
purchaseRevenue AS purchase_revenue,
purchaseCurrency AS purchase_currency,
purchaseCoupon AS purchase_coupon,
productID AS product_id,
productName AS product_name,
productCategory AS product_category,
productPrice AS product_price,
productQuantity AS product_quantity,
productEventType AS product_event_type
FROM ods.event_v;
-- DDS: публичный договор заказа на языке бизнес-модели.
--
-- В отличие от события, у заказа под представлением лежит физическая модель:
-- разбор позиций и пересчёт пояса стоят денег, и платить их при каждом чтении
-- значило бы собирать модель заново на лету (docs/architecture/dds/order.md,
-- «Отклонённые варианты»). Представление здесь ничего не вычисляет — оно
-- только называет колонки, которые слой обещает читателю.
--
-- FINAL нет и не будет: строка на заказ одна по построению, повтор гасит
-- замена партиции, а не колонка версии.
--
-- Служебные колонки перечислены наравне с деловыми — это координаты
-- собственной загрузки слоя, и расследование происшествия начинается с них:
-- по _load_id видно, какой запуск собрал день.
CREATE VIEW IF NOT EXISTS dds.order_v ON CLUSTER clickstream_cluster
AS
SELECT
order_id,
user_id,
status,
order_date,
created_at,
updated_at,
items_total,
discount,
delivery,
total,
item_sku,
item_quantity,
item_price,
_load_id,
_load_ts
FROM dds.order_dist;