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

Что: уточнены заголовки и объяснения в пяти главах и вводной, добавлена
сверка графика с SQL, обновлены ссылки из заданий и документации генератора.

Проверка: SQL и команды сохранены, локальные ссылки проверены;
git diff --check пройден. Ревью смысла Sol 6.1 high замечаний не выявило,
новые пояснения дополнительно сверены с кодом и настройками.
2026-10-18 19:59:21 +02:00

5.3 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;

Выберите одну дату из результата. На дашборде задайте «Период», в который она входит, и обновите график. Наведите указатель на точку этой даты: числа посетителей и известных пользователей должны совпасть с visitors и known_users из SQL.

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

Следующая глава и справочники

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