Примеры создания QL-чартов

В этом руководстве вы создадите чарты на основе SQL-запросов. SQL-запросы позволяют гибче настраивать данные для визуализации, чем стандартный способ — через датасет. Например, в SQL-запрос вы можете добавить параметры с дашбордов.

Рекомендуем использовать QL-чарт в случае, если создание обычного чарта с помощью датасета вам не подходит или вы хотите поэкспериментировать с данными.

В качестве источника данных будет использоваться прямое подключения к демонстрационной БД.

Для визуализации и исследования данных подготовьте DataLens к работе, затем выполните следующие шаги:

1. Создайте воркбук.
2. Создайте подключение.
3. Создайте QL-чарт.
4. Создайте дашборд.
5. Добавьте QL-чарт на дашборд.
6. Добавьте селекторы на дашборд.

Перед началом работыПеред началом работы

Чтобы начать работать с DataLens:

Если у вас возник технический вопрос по работе сервиса, обратитесь в службу поддержки Yandex Cloud. Чтобы спросить совета, обсудить решение вашей задачи или лучшие практики работы сервиса, напишите в чат DataLens в Telegram.

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

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

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

Для доступа к базе данных будет создано подключение Sample ClickHouse.

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

2. В разделе Базы данных выберите подключение ClickHouse®.

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

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

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

   3. Нажмите кнопку Проверить подключение и убедитесь, что появился зеленый значок.

   4. Нажмите кнопку Создать подключение.

      

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

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

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

Создайте QL-чартСоздайте QL-чарт

Создайте QL-чарт на базе подключения Sample ClickHouse:

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

   Примечание

   Убедитесь, что в подключении активирована настройка Уровень доступа SQL-запросов → Разрешить подзапросы в датасетах и запросы из чартов.

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

3. На вкладке Запрос введите текст запроса:

   SELECT 
      toDate(t1.OrderDatetime) as "Дата",
      COUNT(t1.ClientID) as "Число новых клиентов", t3.ClientStatus as "Статус"
   FROM
      samples.MS_SalesFacts t1,
      (SELECT 
          ClientID, 
         MIN(OrderDatetime) as FirstDate
      FROM samples.MS_SalesFacts
      GROUP BY ClientID) as t2,
         samples.MS_Clients t3
   WHERE {{interval_from}} < "Дата" and "Дата" < {{interval_to}} and t1.ClientID=t2.ClientID and t3.ClientID=t2.ClientID and t3.ClientStatus in {{status}} -- status, interval_from и interval_to - переменные, связанные с параметрами, на которые влияют селекторы
   GROUP BY "Статус", "Дата"
   ORDER BY "Дата"
   

4. На вкладке Параметры нажмите Добавить параметр и заполните поля ввода:

   • Из выпадающего списка выберите string (по умолчанию).

   • В поле Имя введите status.

   • В поле Значение по умолчанию введите Золотой.

   • Ниже нажмите Добавить значение и введите Серебряный.

   • Ниже нажмите Добавить значение и введите Базовый.

     

   Добавленный параметр будет связан с переменной {{status}} в запросе.

5. Нажмите Добавить параметр и заполните поля ввода:

   • Из выпадающего списка выберите date-interval.

   • В поле Имя введите interval.

   • Нажмите на поле со значением периода и в открывшемся окне укажите:

     • Начало: 01.03.2017;

     • Конец: 31.03.2017.

       

     • Нажмите Применить.

     Значения Начало: и Конец: добавленного параметра будут связаны соответственно с переменными {{interval_from}} и {{interval_to}} в SQL-запросе.

     Примечание

     Значениями параметров можно управлять при помощи селекторов на дашборде.

6. Вернитесь на вкладку Запрос. В левом нижнем углу нажмите кнопку Запустить. После выполнения запроса появится визуализация в правом окне.

   

7. Настройте визуализацию:

   • Убедитесь, что в секции X находится поле Дата, иначе перетащите его из раздела Доступные.

   • Убедитесь, что в секции Y находится поле Число новых клиентов, иначе перетащите его из раздела Доступные.

   • Добавьте на график цветовое разделение клиентов по статусу. Для этого из секции Доступные перетащите поле Статус в секцию Цвета.

     

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

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

Можете разместить созданный чарт на дашборде. Также на дашборд можно добавить селекторы для управления значениями параметров status и interval QL-чарта.

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

Создайте дашборд, на который будут добавлены чарты и другие виджеты:

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

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

1. На панели в нижней части страницы зажмите Чарт и перетащите его в нужную область.

   

2. В открывшемся окне нажмите кнопку Выбрать.

3. Выберите чарт Новые клиенты.

   

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

5. Установите размер чарта с помощью мыши и расположите его на дашборде в удобном для вас месте.

   

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

Добавьте селекторы, чтобы фильтровать чарты по дате и статусам клиентов:

1. На панели в нижней части страницы зажмите Селектор и перетащите его в нужную область.

   

2. Добавьте селектор по статусам клиентов:

   1. В списке Источник выберите Ручной ввод.

   2. В Поле или параметр введите status. В эту переменную SQL-запроса будут передаваться выбранные значения из селектора.

   3. Выберите тип селектора Список.

   4. Включите опцию Множественный выбор.

   5. Рядом с параметром Возможные значения нажмите кнопку Добавить. В открывшемся окне добавьте значения:

      • Золотой
      • Серебряный
      • Базовый

      

      Нажмите кнопку Применить.

   6. В списке Значение по умолчанию укажите Выбрать всё.

      

   7. В поле Заголовок введите Выберите статус клиента.

   8. Нажмите кнопку Сохранить.

      

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

   1. В списке Источник выберите Ручной ввод.

   2. В Поле или параметр введите interval. В переменные {{interval_from}} и {{interval_to}} SQL-запроса будут передаваться значения начала и конца диапазона из селектора.

   3. Выберите тип селектора Календарь.

   4. Включите опцию Диапазон.

   5. В поле Заголовок введите Период заказов.

   6. Нажмите кнопку Сохранить.

      

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

5. Сохраните дашборд:

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

Дашборд готов.

1. Дашборд готов. Теперь можно фильтровать чарт по статусу с использованием селектора.

   

   Также можно фильтровать чарт по диапазону дат с использованием второго селектора.

   

См. такжеСм. также

• Добавление чарта на дашборд
• Добавление селектора на дашборд
• Создание QL-чарта
• QL-чарты