docs(storage): конвенции и приём событий выправлены после ревью
- Зачем:
- три холодных ревью и сверка с документацией ClickHouse нашли противоречия
между докой, ADR и спекой: исполнитель #37 получал два разных ответа на
один вопрос, а два утверждения о движке оказались неверными.
- Что:
- раскладка файлов DDL перестроена — сначала таблицы, матвью приёма
последней: иначе часть событий тихо минует ODS.
- синхронная вставка снята с пути приёма: настройка недостижима для потока
Kafka-движка и связывает шарды; на ETL-вставках осталась.
- у таблицы ошибок появился класс брака с порядком проверки, у сырья и
ошибок названы движки и ключи сортировки.
- в доку добавлен раздел «Что проверено»: сверенное с документацией,
проверяемое на стенде и сказанное по памяти разведены.
- в спеке выправлены источник матвью разбора, пять опорных колонок, имена
четырёх витрин и ссылка на несуществующую цель make.
- Проверка:
- make config-test
- grep по устаревшим именам файлов DDL и витрин — пусто
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -29,12 +29,14 @@
|
||||
половине кластера, выглядит как честное число. При суффиксе вида голого имени
|
||||
нет вовсе, и та же ошибка становится громкой.
|
||||
|
||||
Второй довод — что группируется в `SHOW TABLES`. Суффикс группирует объекты по
|
||||
сущности: все четыре объекта топика `hits` стоят рядом, потому что различаются
|
||||
Второй довод — что группируется в списке по алфавиту. Суффикс группирует объекты
|
||||
по сущности: все четыре объекта топика `hits` стоят рядом, потому что различаются
|
||||
хвостом. Префиксный стиль, которым пользовался стенд-предшественник (`kafka_*`,
|
||||
`mv_*`, `v_*`), группирует по технологии, и объекты одной сущности
|
||||
расползаются по алфавиту. В хранилище, где у одной сущности живёт по три-четыре
|
||||
воплощения, полезнее первое.
|
||||
воплощения, полезнее первое. Довод про дерево в клиенте и про `ORDER BY name`:
|
||||
порядок выдачи `SHOW TABLES` документация не оговаривает, так что на него здесь
|
||||
опираться нельзя.
|
||||
|
||||
Третий — преемственность: `_rep` и `_dist` уже используются владельцем в других
|
||||
хранилищах на ClickHouse, и общий словарь между стендами стоит больше, чем
|
||||
@@ -60,3 +62,8 @@
|
||||
объектов слоёв STG, ODS, DDS и DM, включая пары локальная/распределённая,
|
||||
представления и матвью. Единственным объектом без выводимого суффикса оказался
|
||||
словарь `products` — отсюда исключение в решении.
|
||||
|
||||
Первый прогон был неполным: четыре витрины из восьми остались с префиксом, и
|
||||
заметило это холодное ревью, а не автор. Имена приведены в порядок 5 августа
|
||||
2026 года. Урок не про имена: «прогнал по документу» — такое же утверждение,
|
||||
как утверждение о поведении системы, и проверять его надо так же.
|
||||
|
||||
Reference in New Issue
Block a user