Как начать работать с DataLens

В этой инструкции вы развернете DataLens локально, создадите свой первый датасет, для визуализации данных построите несколько чартов и разместите их на дашборде.

Разверните DataLensРазверните DataLens

Чтобы развернуть DataLens локально, достаточно запустить несколько контейнеров через Docker Compose:

1. Если у вас нет Docker, установите его по инструкции для вашей платформы:

   • macOS
   • Linux
   • Windows

2. Выполните следующие команды:

   1. Склонируйте репозиторий:

      git clone https://github.com/datalens-tech/datalens
      

   2. Перейдите в директорию с репозиторием и запустите все контейнеры, необходимые для старта DataLens:

      cd <путь_к_папке_datalens> && \
      HC=1 docker compose up
      

      Последнюю команду можно выполнить с параметром для подключения внешней базы данных:

      METADATA_POSTGRES_DSN_LIST="postgres://{user}:{password}@{host}:{port}/{database}" HC=1 docker compose up
      

      Примечание

      Highcharts — это запатентованный коммерческий продукт. Если вы включаете Highcharts в своем экземпляре DataLens (с переменной HC=1), вы должны соблюдать лицензию. С выключенным Highcharts доступны не все типы визуализаций.

3. Перейдите в пользовательский интерфейс DataLens по адресу http://localhost:8080.

После запуска DataLens вы сможете:

• изучить демо-примеры;
• подключить источники;
• построить свои дашборды.

В первый релиз открытой версии входит все необходимое, чтобы опробовать возможности DataLens на своей инфраструктуре. Сейчас в репозитории опубликовано ядро сервиса, набор основных подключений (PostgreSQL, ClickHouse® и YTsaurus) и основные части интерфейса.

Создайте воркбукСоздайте воркбук

1. Перейдите на главную страницу DataLens.
2. На панели слева выберите Коллекции и воркбуки.
3. В правом верхнем углу нажмите Создать → Создать воркбук.
4. Укажите название воркбука.
5. Нажмите кнопку Создать.

Создайте подключениеСоздайте подключение

1. Перейдите на страницу воркбука.

2. В правом верхнем углу нажмите Создать → Подключение.

3. Выберите подключение ClickHouse.

   1. В открывшемся окне укажите параметры подключения:

      • Имя хоста — rc1a-ckg8nrosr2lim5iz.mdb.yandexcloud.net.
      • Порт HTTP-интерфейса — 8443 (по умолчанию).
      • Имя пользователя — samples_ro.
      • Пароль — MsgfcjEhJk.

   2. Активируйте опцию Разрешить подзапросы в датасетах и запросы из чартов.

   3. Проверьте подключение и нажмите кнопку Создать подключение.

   4. Введите название подключения — Sample ClickHouse.

   5. Нажмите кнопку Создать.

   

Дождитесь сохранения подключения.

Создайте датасетСоздайте датасет

1. В правом верхнем углу нажмите кнопку Создать датасет.

2. Перенесите на рабочую область таблицу MS_SalesMiniTable.

   

3. Перейдите на вкладку Поля.

4. В столбце Агрегация для поля Sales выберите Сумма.

5. Создайте показатель с количеством заказов:

   1. Переименуйте поле OrderID в OrderCount.
   2. Измените тип агрегации на Количество уникальных.

6. Для поля ShopAddressCoord измените тип данных на Геоточка.

7. Сохраните датасет:

   1. В правом верхнем углу нажмите кнопку Сохранить.
   2. Введите имя датасета и нажмите кнопку Создать.

   

Создайте чарт — столбчатая диаграммаСоздайте чарт — столбчатая диаграмма

1. В правом верхнем углу нажмите кнопку Создать чарт.

2. Выберите тип визуализации Столбчатая диаграмма.

3. Добавьте на чарт подкатегорию товаров. Для этого из раздела Измерения перетащите поле ProductSubcategory в секцию X.

4. Добавьте на чарт показатель продаж. Для этого из раздела Показатели перетащите поле Sales в секцию Y.

5. Отсортируйте чарт по убыванию по показателю продаж — из раздела Показатели перетащите поле Sales в секцию Сортировка.

6. Сохраните чарт:

   1. В правом верхнем углу нажмите кнопку Сохранить.
   2. В открывшемся окне введите название чарта Продажи по подкатегориям и нажмите кнопку Сохранить.

   

Создайте чарт — накопительная диаграмма с областямиСоздайте чарт — накопительная диаграмма с областями

1. В созданном на предыдущем шаге чарте выберите тип визуализации Накопительная диаграмма с областями.

2. Замените подкатегории товаров на дату заказа на оси X. Для этого из раздела Измерения перетащите поле OrderDate в секцию X и наведите его над полем ProductSubcategory, пока то не станет красным.

3. Добавьте на чарт категорию товаров. Для этого из раздела Измерения перетащите поле ProductCategory в секцию Цвета.

4. Отобразите чарт по неделям:

   1. В секции X нажмите на иконку с календарем у поля OrderDate.
   2. В поле Группировка выберите Округление → Неделя.
   3. Нажмите кнопку Применить.

5. Сохраните чарт:

   1. В правом верхнем углу нажмите значок → Сохранить как копию.
   2. В открывшемся окне введите название нового чарта Продажи по неделям и нажмите кнопку Сохранить.

   

Создайте чарт — круговая диаграммаСоздайте чарт — круговая диаграмма

1. В созданном на предыдущем шаге чарте выберите тип визуализации Круговая диаграмма.

2. Добавьте на чарт категорию товаров. Для этого из раздела Измерения перетащите поле ProductCategory в секцию Цвета.

3. Добавьте на чарт показатель продаж. Для этого из раздела Показатели перетащите поле Sales в секцию Показатели.

4. Добавьте подпись к показателям:

   1. Из раздела Показатели перетащите поле Sales в секцию Подписи.
   2. Нажмите на значок слева от названия показателя.
   3. В открывшемся окне для настройки Значение подписи выберите В процентах и нажмите кнопку Применить.

5. Сохраните чарт:

   1. В правом верхнем углу нажмите значок → Сохранить как копию.
   2. В открывшемся окне введите название нового чарта Продажи по категориям и нажмите кнопку Сохранить.

   

Создайте дашбордСоздайте дашборд

1. Перейдите на страницу воркбука.
2. В правом верхнем углу нажмите Создать → Дашборд.
3. Введите название дашборда и нажмите кнопку Создать.

Добавьте чарты на дашбордДобавьте чарты на дашборд

1. В правом верхнем углу нажмите кнопку Добавить и выберите Чарт.

2. Выберите чарт Продажи по подкатегориям. После этого автоматически заполнится поле Название.

3. Нажмите кнопку Добавить.

4. Аналогичным способом добавьте чарты Продажи по месяцам и Продажи по категориям.

5. Расположите чарты на дашборде в удобном для вас порядке.

6. Сохраните дашборд. Для этого в правом верхнем углу нажмите кнопку Сохранить.

   

Добавьте селектор на дашбордДобавьте селектор на дашборд

1. В правом верхнем углу нажмите кнопку Редактировать.

2. Нажмите кнопку Добавить и выберите Селектор.

3. Добавьте селектор с календарем по датам заказа:

   1. Выберите созданный датасет.
   2. Выберите поле OrderDate. После этого автоматически заполнится поле Название.
   3. Включите опцию Диапазон.
   4. Нажмите кнопку Добавить.

4. Расположите селектор на дашборде в удобном для вас месте.

5. Сохраните дашборд. Для этого в правом верхнем углу нажмите кнопку Сохранить.

   

Что дальшеЧто дальше

• Ознакомьтесь с концепциями сервиса.
• Посмотрите пример готового дашборда.

ClickHouse® является зарегистрированным товарным знаком ClickHouse, Inc.