# Использование параметров в вычисляемых полях


{% note warning %}

Часть ресурсов, необходимых для прохождения практического руководства, доступны только в [регионе Россия](../../overview/concepts/region.md).

{% endnote %}


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

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

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

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


Для визуализации и исследования данных [подготовьте DataLens к работе](#before-you-begin), затем выполните следующие шаги:


1. [Создайте подключение](#create-connection).
1. [Создайте датасет](#create-dataset).
1. [Добавьте параметры в датасет](#create-dataset-parameters).
1. [Создайте чарт с возможностью управления группировкой даты](#create-chart-grouping).
1. [Создайте чарт с выбором измерения для визуализации](#create-chart-measure-select).
1. [Создайте дашборд](#create-dashboard).
1. [Добавьте чарты на дашборд](#add-charts-on-dashboard).
1. [Добавьте селекторы на дашборд](#add-selectors-on-dashboard).


## Перед началом работы {#before-you-begin}

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


{% list tabs group=datalens_user %}

- Новый пользователь {#new}

  1. [Войдите](https://passport.yandex.ru/auth) в ваш аккаунт на Яндексе. Если у вас еще нет аккаунта, [создайте](https://yandex.ru/support/passport/authorization/registration.html) его.
  1. Откройте [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. Подтвердите, что ознакомились с [Условиями использования](https://yandex.ru/legal/cloud_termsofuse/?lang=ru) и принимаете их и нажмите кнопку **Войти**.

- Уже использую Yandex Cloud {#already}

  1. [Войдите](https://passport.yandex.ru/auth) в ваш аккаунт на Яндексе.
  1. Откройте [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. Выберите один из вариантов:

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

       {% note info %}

       Для активации экземпляра DataLens пользователю нужна роль `admin` или `owner`. Подробнее про роли смотрите в разделе [Управление доступом в Yandex Identity Hub](../../organization/security/index.md).

       {% endnote %}

     * Если у вас есть облако, но нет организации, нажмите **Добавить новый DataLens**. В открывшемся окне введите название и описание организации и нажмите **Создать организацию и DataLens**. Подробнее о работе с организациями смотрите в разделе [Начало работы с организациями](../../organization/quickstart.md).

{% endlist %}

Если у вас возник технический вопрос по работе сервиса, обратитесь в [службу поддержки](https://kz.center.yandex.cloud/support) Yandex Cloud. Чтобы спросить совета, обсудить решение вашей задачи или лучшие практики работы сервиса, напишите в чат [DataLens](https://t.me/YandexDataLens) в Telegram.


## Создайте подключение {#create-connection}

{% note warning %}

Если вы работаете с новой объектной моделью DataLens, включающей [воркбуки и коллекции](../../datalens/workbooks-collections/index.md):

1. Перейдите на [главную страницу](https://datalens.ru/?skipPromo=true) DataLens. На панели слева выберите ![collections](../../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**.
1. Откройте воркбук, в правом верхнем углу нажмите **Создать** и выберите нужный объект.

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

{% endnote %}



1. Перейдите на [страницу подключений](https://datalens.ru/connections).
1. Нажмите кнопку **Создать подключение**.



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

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

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

    1. Активируйте опцию **SQL на чтение**.
    1. Проверьте подключение и нажмите кнопку **Создать подключение**.
    1. Введите название подключения — `Sample ClickHouse`.
    1. Нажмите кнопку **Создать**.


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

## Создайте датасет {#create-dataset}

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

1. Перенесите на рабочую область таблицу **MS_SalesFullTable**.

   ![image](../../_assets/datalens/solution-parameters/add-table.png)

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

   ![image](../../_assets/datalens/solution-parameters/dataset-field-tab.png)

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

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

      ![image](../../_assets/datalens/solution-parameters/dataset-dublicate-field.png)

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

      ![image](../../_assets/datalens/solution-parameters/dataset-rename-field.png)

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

   ![image](../../_assets/datalens/solution-parameters/dataset-choose-agg.png)

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

1. В правом верхнем углу нажмите кнопку **Сохранить**.
1. Введите имя датасета **Moscow Sales dataset with parameters**, нажмите **Создать**.

## Добавьте параметры в датасет {#create-dataset-parameters}

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

   ![image](../../_assets/datalens/solution-parameters/dataset-parameters-tab.png)

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

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

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

      ![image](../../_assets/datalens/solution-parameters/dataset-add-parameter.png)

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

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

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

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

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

## Создайте чарт с возможностью управления группировкой даты {#create-chart-grouping}

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

   ![image](../../_assets/datalens/solution-parameters/select-area-chart.png)

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

   1. В левой части экрана под датасетом нажмите значок ![image](../../_assets/console-icons/plus.svg) и выберите **Поле**.
   1. В окне **Настройка поля** введите:
   
      * В поле **Название** — `Date`.
      * В поле для ввода формулы — `DATETRUNC([OrderDate], [scale])`. Дата заказа будет округляться в зависимости от значения параметра датасета `scale`.

        ![image](../../_assets/datalens/solution-parameters/chart-add-field.png)

   1. Нажмите **Создать**.
   1. Перетащите новое поле **Date** в секцию **X**.

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

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

      ![image](../../_assets/datalens/solution-parameters/save-chart-grouping.png)

## Создайте чарт с возможностью выбора измерения для визуализации {#create-chart-measure-select}

1. В верхнем правом углу датасета нажмите **Создать чарт**.
1. Выберите тип визуализации **Линейчатая диаграмма**.
1. Добавьте в чарт вычисляемое поле для выбора измерения:

   1. В левой части экрана под датасетом нажмите значок ![image](../../_assets/console-icons/plus.svg) и выберите **Поле**.
   1. В окне **Настройка поля** введите:
   
      * В поле **Название** — `Field`.
      * В поле для ввода формулы: 

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

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

   1. Нажмите **Создать**.
   1. Перетащите новое поле **Field** в секцию **Y**.

1. Перетащите показатель **Sales** в секцию **X**.
1. Сохраните чарт.

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

      ![image](../../_assets/datalens/solution-parameters/save-chart-measure-select.png)

## Создайте дашборд {#create-dashboard}

Создайте [дашборд](../../datalens/concepts/dashboard.md), на который будут добавлены чарты.

1. На панели слева нажмите ![image](../../_assets/console-icons/layout-cells-large.svg) **Дашборды**.
1. Нажмите кнопку **Создать дашборд**.

## Добавьте чарты на дашборд {#add-charts-on-dashboard}

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

   ![image](../../_assets/datalens/solution-parameters/add-chart.png)

1. В поле **Чарт** нажмите кнопку **Выбрать**.
1. Выберите чарт **Продажи по категориям товаров**. После этого автоматически заполнится поле **Название**.
1. Нажмите кнопку **Добавить**.

   ![image](../../_assets/datalens/solution-parameters/add-chart-window.png)

1. Аналогичным способом добавьте чарт **Чарт с выбором измерения для визуализации**.
1. Расположите чарты на дашборде в удобном для вас порядке.
1. Сохраните дашборд:

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

## Добавьте селекторы на дашборд {#add-selectors-on-dashboard}

Добавьте [селекторы](../../datalens/dashboard/selector.md) с ручным вводом, чтобы менять значения параметров в чартах.

{% note warning %}

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

{% endnote %}

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

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

      ![image](../../_assets/datalens/solution-parameters/add-selector.png)

   1. Выберите тип источника **Ручной ввод**.
   1. В **Имя поля или параметра** введите `scale`. В этот параметр датасета будет передаваться выбранное значение из селектора.
   1. Выберите тип селектора **Список**.
   1. Рядом с параметром **Значение по умолчанию** нажмите на поле ввода и добавьте значения:

      * `day`
      * `week`
      * `month`
      * `year`

      ![image](../../_assets/datalens/solution-parameters/add-selector-values.png)

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

   1. В списке **Значение по умолчанию** укажите **month**.
   1. Включите опцию **Название** и введите `Группировка`.
   1. Проверьте указанные параметры селектора.

      ![image](../../_assets/datalens/solution-parameters/add-selector-parameters.png)

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

      ![image](../../_assets/datalens/solution-parameters/chart-grouping-w.png)

      ![image](../../_assets/datalens/solution-parameters/chart-grouping-y.png)

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

   1. В верхней части страницы нажмите кнопку **Добавить**.
   1. Выберите **Селектор**.
   1. Выберите тип источника **Ручной ввод**.
   1. В **Имя поля или параметра** введите `dimension`. В этот параметр датасета будет передаваться выбранное значение из селектора.
   1. Выберите тип селектора **Список**.
   1. Рядом с параметром **Значение по умолчанию** нажмите на поле ввода и добавьте значения:

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

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

   1. В списке **Значение по умолчанию** укажите **Статус**.
   1. Включите опцию **Название** и введите `Измерение`.
   1. Нажмите кнопку **Добавить**.
   1. Расположите селектор на дашборде над чартом **Чарт с выбором измерения для визуализации**.
   1. Разорвите связь этого селектора с селектором **Группировка**:

      1. В верхней части экрана нажмите значок ![image](../../_assets/console-icons/gear.svg). Справа откроется окно настроек.
      1. В окне настроек нажмите **Связи** ![image](../../_assets/console-icons/sliders-vertical.svg).
      1. В окне **Связи** выберите **Измерение**.
      1. Проверьте, что с чартом **Чарт с выбором измерения для визуализации** установлен тип связи **Исх.связь**. Для селектора **Группировка** установите тип связи **Игнор**.

         ![image](../../_assets/datalens/solution-parameters/alias-ignor.png)

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

         ![image](../../_assets/datalens/solution-parameters/chart-measure-select-cat.png)

         ![image](../../_assets/datalens/solution-parameters/chart-measure-select-pay.png)

#### Полезные ссылки {#see-also}

* [Параметры в Yandex DataLens](../../datalens/concepts/parameters.md)
* [Добавление параметров на дашборд в Yandex DataLens](../../datalens/operations/dashboard/add-parameters.md)
* [Добавление параметра в чарт Yandex DataLens](../../datalens/operations/chart/add-parameter-chart.md)
* [Добавить параметры](../../datalens/dataset/create-dataset.md#add-parameters)

_ClickHouse® является зарегистрированным товарным знаком [ClickHouse, Inc](https://clickhouse.com)._