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

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

Разверните DataLens

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

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

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

    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), вы должны соблюдать лицензию.

  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. Нажмите кнопку Создать.

    create-connection

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

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

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

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

    drag-table

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

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

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

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

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

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

    create-dataset

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

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

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

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

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

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

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

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

    create-chart-1

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

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

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

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

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

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

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

    create-chart-2

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

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

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

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

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

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

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

    create-chart-2

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

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

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

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

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

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

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

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

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

    add-charts

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

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

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

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

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

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

    add-selectors

Что дальше