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

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

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

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

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

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

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

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

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

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

1. Перейдите на страницу подключений.

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

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

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

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

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

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

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

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

   

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

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

1. Перейдите к уже созданному подключению БД.

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

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

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

   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 "Дата"
   

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

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

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

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

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

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

     

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

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

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

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

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

     • От: 2017-03-01;

     • До: 2017-03-31.

       

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

     Примечание

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

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

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

   • Выберите тип диаграммы Столбчатая диаграмма.

     

   • Убедитесь, что поле Дата расположено в секции X.

   • Убедитесь, что поле Число новых клиентов расположено в секции Y.

   • Убедитесь, что поле Статус расположено в секции Colors.

   • Проверьте, чтобы секция Available была пустая. В эту секцию попадают поля, не участвующие в расчетах. В противном случае визуализация будет отображаться некорректно.

     

9. В правом верхнем углу нажмите Сохранить.

10. Введите название чарта: Новые клиенты и нажмите Сохранить.

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

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

Создайте дашборд, на который будут добавлены чарты.

1. Перейдите на главную страницу DataLens.

2. Нажмите кнопку Создать дашборд.

   

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

1. В верхней части страницы нажмите кнопку Добавить и выберите Чарт.

   

2. В поле Чарт нажмите Выбрать и выберите из списка чартов созданный ранее чарт Новые клиенты.

   

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

3. Чарт появился на дашборде. Растяните его для улучшения визуализации.

   

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

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

   1. В верхней части страницы нажмите кнопку Добавить.

   2. Выберите Селектор.

      

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

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

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

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

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

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

      

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

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

      

   9. Включите опцию Название и введите Выберите статус клиента.

   10. Проверьте указанные параметры селектора.

       

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

   12. Расположите селектор на дашборде над чартом.

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

   1. В верхней части страницы нажмите кнопку Добавить.

   2. Выберите Селектор.

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

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

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

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

   7. Включите опцию Название и введите Период заказов.

   8. Проверьте указанные параметры селектора.

      

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

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

   11. В правом верхнем углу дашборда нажмите кнопку Сохранить.

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

       

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

   

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

   

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

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