Связаться с намиПодключиться

Использование параметров

Статья создана
Обновлена 6 марта 2025 г.

Параметр — это переменная, которая может заменять константные значения в вычисляемых полях.

Вы научитесь управлять визуализацией с помощью параметров:

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

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

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

  1. Создайте подключение.
  2. Создайте датасет.
  3. Добавьте параметры в датасет.
  4. Создайте чарт с возможностью управления группировкой даты.
  5. Создайте чарт с выбором измерения для визуализации.
  6. Создайте дашборд.
  7. Добавьте чарты на дашборд.
  8. Добавьте селекторы на дашборд.

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

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

  1. Войдите в ваш аккаунт на Яндексе. Если у вас еще нет аккаунта, создайте его.
  2. Откройте главную страницу DataLens.
  3. Нажмите Открыть сервис.
  4. Подтвердите, что ознакомились с Условиями использования и принимаете их и нажмите кнопку Войти.

  1. Войдите в ваш аккаунт на Яндексе.

  2. Откройте главную страницу DataLens.

  3. Нажмите Открыть сервис.

  4. Выберите один из вариантов:

    • Если у вас уже есть организация, выберите ее в выпадающем меню на вкладке Организации и нажмите DataLens.

      Примечание

      Для активации экземпляра DataLens пользователю нужна роль admin или owner. Подробнее про роли см. в разделе Управление доступом в Yandex Cloud Organization.

    • Если у вас есть облако, но нет организации, нажмите Добавить новый DataLens. В открывшемся окне введите название и описание организации и нажмите Создать организацию и DataLens. Подробнее о работе с организациями см. в разделе Начало работы с организациями.

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

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

Важно

Если вы работаете с новой объектной моделью DataLens, включающей воркбуки и коллекции:

  1. Перейдите на главную страницу DataLens. На панели слева выберите Коллекции и воркбуки.
  2. Откройте воркбук, в правом верхнем углу нажмите Создать и выберите нужный объект.

Продолжайте инструкцию с шага 3.

  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_SalesFullTable.

    image

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

    image

  4. Создайте поле с датой заказа OrderDate.

    1. Продублируйте поле OrderDatetime.

      image

    2. Переименуйте дубликат поля OrderDatetime (1) в OrderDate: нажмите на имя строки, удалите текущее имя и введите новое.

    3. Измените тип данных с Дата и время на Дата.

      image

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

    image

    Поле с агрегацией станет показателем и поменяет цвет на синий.

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

  7. Введите имя датасета Moscow Sales dataset with parameters, нажмите Создать.

Добавьте параметры в датасет

  1. Перейдите на вкладку Параметры.

    image

  2. Добавьте параметры scale и dimension:

    1. Нажмите кнопку Добавить и в открывшемся окне укажите:

      • Название — scale.
      • Тип — Строка.
      • Значение по умолчанию — month.

      image

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

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

      • Название — dimension.
      • Тип — Строка.
      • Значение по умолчанию — Статус.

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

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

Создайте чарт с возможностью управления группировкой даты

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

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

    image

  3. Добавьте в чарт вычисляемое поле:

    1. В левой части экрана под датасетом нажмите значок и выберите Поле.

    2. В окне Настройка поля введите:

      • В поле Название — Date.

      • В поле для ввода формулы — DATETRUNC([OrderDate], [scale]). Дата заказа будет округляться в зависимости от значения параметра датасета scale.

        image

    3. Нажмите Создать.

    4. Перетащите новое поле Date в секцию X.

  4. Перетащите показатель Sales в секцию Y.

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

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

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

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

      image

Создайте чарт с возможностью выбора измерения для визуализации

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

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

  3. Добавьте в чарт вычисляемое поле для выбора измерения:

    1. В левой части экрана под датасетом нажмите значок и выберите Поле.

    2. В окне Настройка поля введите:

      • В поле Название — Field.

      • В поле для ввода формулы:

        if(
     [dimension] = 'Статус', [ClientStatus],
     [dimension] = 'Категория', [ProductCategory],
     [dimension] = 'Тип оплаты', [PaymentType],
     null
   )

        Измерение для визуализации будет меняться в зависимости от значения параметра датасета dimension.

    3. Нажмите Создать.

    4. Перетащите новое поле Field в секцию Y.

  4. Перетащите показатель Sales в секцию X.

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

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

    2. Введите название чарта Чарт с выбором измерения для визуализации и нажмите кнопку Сохранить.

      image

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

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

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

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

    image

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

  1. При первом открытии после сохранения дашборд открывается в режиме редактирования. Если вы открыли его повторно, то нажмите Редактировать в правом верхнем углу.

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

    image

  3. В поле Чарт нажмите кнопку Выбрать.

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

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

    image

  6. Аналогичным способом добавьте чарт Чарт с выбором измерения для визуализации.

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

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

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

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

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

Важно

После добавления селектора разорвите его связь с другими селекторами на этой вкладке дашборда.

  1. Чтобы перейти в режим редактирования дашборда, нажмите Редактировать в правом верхнем углу.

  2. Добавьте селектор для чарта Продажи по категориям товаров:

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

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

      image

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

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

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

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

      • day
      • week
      • month
      • year

      image

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

    7. В списке Значение по умолчанию укажите month.

    8. Включите опцию Название и введите Группировка.

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

      image

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

    11. Расположите селектор на дашборде над чартом Продажи по категориям товаров. Теперь вы можете управлять группировкой даты в этом чарте.

      image

      image

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

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

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

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

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

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

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

      • Статус
      • Категория
      • Тип оплаты

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

    7. В списке Значение по умолчанию укажите Статус.

    8. Включите опцию Название и введите Измерение.

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

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

    11. Разорвите связь этого селектора с селектором Группировка:

      1. В верхней части страницы нажмите кнопку Связи.

      2. В окне Связи выберите Измерение.

      3. Проверьте, что с чартом Чарт с выбором измерения для визуализации установлен тип связи Исх.связь. Для селектора Группировка установите тип связи Игнор.

        image

      4. Нажмите кнопку Сохранить. Теперь с помощью этого селектора вы можете выбирать измерение для визуализации.

        image

        image

См. также

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

Предыдущая
Миграция базы данных из Google BigQuery в Managed Service for ClickHouse®
Следующая
Примеры создания QL-чартов