Как начать работать с DataLens
В этой инструкции вы развернете DataLens локально, создадите свой первый датасет, для визуализации данных построите несколько чартов и разместите их на дашборде.
Разверните DataLens
Чтобы развернуть DataLens локально, достаточно запустить несколько контейнеров через Docker Compose:
Если у вас нет Docker, установите его по инструкции для вашей платформы:
Выполните следующие команды:
git clone https://github.com/datalens-tech/datalenscd datalensHC=1 docker compose up
Последняя команда запустит все контейнеры, необходимые для старта DataLens. Можете выполнить ее с параметром для подключения внешней базы данных:
METADATA_POSTGRES_DSN_LIST="postgres://{user}:{password}@{host}:{port}/{database}" HC=1 docker compose up
Примечание
Highcharts — это запатентованный коммерческий продукт. Если вы включаете Highcharts в своем экземпляре DataLens (с переменной
HC=1
), вы должны соблюдать лицензию.Перейдите в пользовательский интерфейс DataLens по адресу
http://localhost:8080
.
После запуска DataLens вы сможете:
В первый релиз открытой версии входит все необходимое, чтобы опробовать возможности DataLens на своей инфраструктуре. Сейчас в репозитории опубликовано ядро сервиса, набор основных подключений (PostgreSQL, ClickHouse® и YTsaurus) и основные части интерфейса.
Создайте воркбук
- Перейдите на главную страницу DataLens.
- На панели слева выберите
- В правом верхнем углу нажмите Создать → Создать воркбук.
- Укажите название воркбука.
- Нажмите кнопку Создать.
Создайте подключение
Перейдите на страницу воркбука.
В правом верхнем углу нажмите Создать → Подключение.
Выберите подключение ClickHouse.
В открывшемся окне укажите параметры подключения:
- Имя хоста —
rc1a-ckg8nrosr2lim5iz.mdb.yandexcloud.net
. - Порт HTTP-интерфейса —
8443
(по умолчанию). - Имя пользователя —
samples_ro
. - Пароль —
MsgfcjEhJk
.
- Имя хоста —
Активируйте опцию Разрешить подзапросы в датасетах и запросы из чартов.
Проверьте подключение и нажмите кнопку Создать подключение.
Введите название подключения —
Sample ClickHouse
.Нажмите кнопку Создать.
Дождитесь сохранения подключения.
Создайте датасет
В правом верхнем углу нажмите кнопку Создать датасет.
Перенесите на рабочую область таблицу
MS_SalesMiniTable
.Перейдите на вкладку Поля.
В столбце Агрегация для поля
Sales
выберите Сумма.Создайте показатель с количеством заказов:
- Переименуйте поле
OrderID
вOrderCount
. - Измените тип агрегации на Количество уникальных.
- Переименуйте поле
Для поля
ShopAddressCoord
измените тип данных на Геоточка.Сохраните датасет:
- В правом верхнем углу нажмите кнопку Сохранить.
- Введите имя датасета и нажмите кнопку Создать.
Создайте чарт — столбчатая диаграмма
В правом верхнем углу нажмите кнопку Создать чарт.
Выберите тип визуализации Столбчатая диаграмма.
Добавьте на чарт подкатегорию товаров. Для этого из раздела Измерения перетащите поле
ProductSubcategory
в секцию X.Добавьте на чарт показатель продаж. Для этого из раздела Показатели перетащите поле
Sales
в секцию Y.Отсортируйте чарт по убыванию по показателю продаж — из раздела Показатели перетащите поле
Sales
в секцию Сортировка.Сохраните чарт:
- В правом верхнем углу нажмите кнопку Сохранить.
- В открывшемся окне введите название чарта Продажи по подкатегориям и нажмите кнопку Сохранить.
Создайте чарт — накопительная диаграмма с областями
В созданном на предыдущем шаге чарте выберите тип визуализации Накопительная диаграмма с областями.
Замените подкатегории товаров на дату заказа на оси X. Для этого из раздела Измерения перетащите поле
OrderDate
в секцию X и наведите его над полемProductSubcategory
, пока то не станет красным.Добавьте на чарт категорию товаров. Для этого из раздела Измерения перетащите поле
ProductCategory
в секцию Цвета.Отобразите чарт по неделям:
- В секции X нажмите на иконку с календарем у поля
OrderDate
. - В поле Группировка выберите Округление → Неделя.
- Нажмите кнопку Применить.
- В секции X нажмите на иконку с календарем у поля
Сохраните чарт:
- В правом верхнем углу нажмите значок
- В открывшемся окне введите название нового чарта Продажи по неделям и нажмите кнопку Сохранить.
- В правом верхнем углу нажмите значок
Создайте чарт — круговая диаграмма
В созданном на предыдущем шаге чарте выберите тип визуализации Круговая диаграмма.
Добавьте на чарт категорию товаров. Для этого из раздела Измерения перетащите поле
ProductCategory
в секцию Цвета.Добавьте на чарт показатель продаж. Для этого из раздела Показатели перетащите поле
Sales
в секцию Показатели.Добавьте подпись к показателям:
- Из раздела Показатели перетащите поле
Sales
в секцию Подписи. - Нажмите на значок слева от названия показателя.
- В открывшемся окне для настройки Значение подписи выберите В процентах и нажмите кнопку Применить.
- Из раздела Показатели перетащите поле
Сохраните чарт:
- В правом верхнем углу нажмите значок
- В открывшемся окне введите название нового чарта Продажи по категориям и нажмите кнопку Сохранить.
- В правом верхнем углу нажмите значок
Создайте дашборд
- Перейдите на страницу воркбука.
- В правом верхнем углу нажмите Создать → Дашборд.
- Введите название дашборда и нажмите кнопку Создать.
Добавьте чарты на дашборд
В правом верхнем углу нажмите кнопку Добавить и выберите Чарт.
Выберите чарт Продажи по подкатегориям. После этого автоматически заполнится поле Название.
Нажмите кнопку Добавить.
Аналогичным способом добавьте чарты Продажи по месяцам и Продажи по категориям.
Расположите чарты на дашборде в удобном для вас порядке.
Сохраните дашборд. Для этого в правом верхнем углу нажмите кнопку Сохранить.
Добавьте селектор на дашборд
В правом верхнем углу нажмите кнопку Редактировать.
Нажмите кнопку Добавить и выберите Селектор.
Добавьте селектор с календарем по датам заказа:
- Выберите созданный датасет.
- Выберите поле
OrderDate
. После этого автоматически заполнится поле Название. - Включите опцию Диапазон.
- Нажмите кнопку Добавить.
Расположите селектор на дашборде в удобном для вас месте.
Сохраните дашборд. Для этого в правом верхнем углу нажмите кнопку Сохранить.
Что дальше
- Ознакомьтесь с концепциями сервиса.
- Посмотрите пример готового дашборда.
ClickHouse® является зарегистрированным товарным знаком ClickHouse, Inc.