Files
clickstream-data-platform/docs/handbook/superset.md
T
ddadmin 915e976fc2 docs(handbook): упрощен язык путеводителя по стенду
Зачем: помочь учащемуся понять путь данных и работу служб перед выполнением заданий.

Что: вычитаны оглавление и пять глав, пояснены термины, убраны внутренние метафоры и повторы. Уточнены пояснения к SQL и показателям мониторинга.

Проверка: 62 локальные ссылки и 6 входящих ссылок на разделы проверены; 8 блоков SQL и схем сохранены. git diff --cached --check прошел.
2026-09-13 13:02:40 -04:00

4.7 KiB

Немного Superset

Superset показывает витрины слоя DM в виде графиков. К ClickHouse он подключается пользователем bi. Дашборд стенда «Бизнес-сюжеты» собран из трех витрин:

Витрина Что показывает
dm.revenue_daily_v Выручку, число заказов и средний чек; выручку по дням и категориям товаров, долю каждой категории
dm.purchase_vs_orders_v Результат сверки покупок из кликстрима с заказами: сколько заказов за день относится к каждому виду расхождения
dm.daily_traffic_v Число посетителей и известных пользователей по дням, долю известных пользователей

Известные пользователи — те, кого удалось связать с посетителями сайта по заказам. Эти связи хранятся в карте идентичностей DDS.

Слева от панелей стоит фильтр «Период». Он задает даты сразу для всех панелей.

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

В Superset сначала создается датасет — описание таблицы или представления, из которого будут браться данные. В нем задаются подписи колонок, формат чисел и показатели, например средний чек.

Затем на основе датасета создается график: выбираются показатели и способ их отображения. Несколько графиков можно разместить на одном дашборде.

Стендовые объекты и ваши

Готовые датасеты, графики и дашборд сохранены в файлах репозитория и импортируются при каждом make up. Если изменить их через интерфейс, следующий make up заменит изменения версией из файлов без предупреждения.

Созданные вами датасеты, графики и дашборды хранятся в базе метаданных Superset. Импорт их не меняет: они сохраняются после make up и make rebuild-storage. Команда make clean удалит их вместе со всеми данными стенда. Для учебных отчетов создавайте собственные объекты, чтобы повторный запуск не перезаписал вашу работу. Устройство импорта описано в справочнике Superset.

Почему выручка отстает на день

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

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

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

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

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

Куда дальше

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