Files
clickstream-data-platform/docs/handbook/superset.md
T
ddadminandClaude Fable 5.1 ac21399fe4 docs(handbook): написаны четыре главы путеводителя
Зачем: после главы о хранилище путеводитель обещал еще четыре главы, а
вместо них стояли заглушки «Пока главы нет…». Без них читатель не видит,
кто двигает мир и раскладывает данные по слоям, куда смотреть в Grafana,
как витрина становится графиком и откуда берутся данные.

Что: docs/handbook/airflow-dags.md, monitoring.md, superset.md,
generator.md — по скелетам тикета #220, форма — как у главы о хранилище.
Сквозная линия трех глав: ход мира на день D везет слепок заказов дня D−1,
поэтому выручка всегда на день позади кликстрима. README путеводителя
ведет заголовками в файлы глав, заглушки убраны; «Куда дальше» главы о
хранилище ведет прямо в главу об Airflow.

Проверка: три SELECT из глав прогнаны на живом стенде от analyst — трафик
получил сыгранный день, выручка только предыдущий, счетчики первых восьми
дней совпали с паспортом мира. Скрипт проверки ссылок и запретных слов из
тикета пуст. Постановка отревьюена Opus (18 находок внесены); главы прошли
саморевью Sol и два слепых ревью Opus — факты и проза (ai-text-lint плюс
оптика литературного русского): 25 находок внесены, 1 отклонена.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-02 17:14:43 -04:00

3.4 KiB

Немного Superset

Superset — это витрины глазами. Он читает слой DM пользователем bi. На дашборде стенда «Бизнес-сюжеты» три графика:

График Витрина
«Выручка по дням и категориям» dm.revenue_daily_v
«Сверка purchase и заказов» dm.purchase_vs_orders_v
«Посетители и известные пользователи» dm.daily_traffic_v

Как витрина становится графиком

Путь состоит из трех объектов: датасет → график → дашборд. Датасет описывает витрину: он несет русские имена колонок и формат денег. График ссылается на эти имена и задает способ показа. Дашборд собирает готовые графики на одном экране.

Свое и стендовое

Стендовые объекты приезжают из файлов при каждом make up. Правка такого датасета, графика или дашборда в интерфейсе живет до следующей инициализации, а затем молча заменяется версией из репозитория.

Ваши объекты живут рядом в базе метаданных Superset. Они переживают make up и make rebuild-storage. Только make clean стирает их вместе с остальным постоянным состоянием стенда. Поэтому стендовые объекты оставляйте как есть, а свои отчеты стройте рядом. Устройство импорта описано в справочнике Superset.

Почему края графиков не совпадают

Правый край выручки всегда на день позади кликстрима. Слепок заказов дня приезжает со следующим ходом мира. Так устроен источник. Вы уже видели этот сдвиг в главе об Airflow. Начальное состояние показано в разделе «Стартовый мир».

Посмотрите сами

Откройте Superset по адресу из раздела «Адреса и пароли» и выберите дашборд «Бизнес-сюжеты». Затем откройте SQL Lab и выполните запрос:

SELECT report_date, visitors, known_users
FROM dm.daily_traffic_v
ORDER BY report_date DESC
LIMIT 7;

Как построить свой отчет, рассказывают учебные задания.

Куда дальше

Устройство BI-зоны описано в справочнике Superset, а состав витрин — в справочнике DM. Следующая глава — «Генератор: откуда берутся данные».