[Документация Yandex Cloud](../../../index.md) > [Yandex DataLens](../../index.md) > Вычисляемые поля > Обзор

# Вычисляемые поля в Yandex DataLens

Вычисляемое поле — это дополнительное [поле данных](../../dataset/index.md#field), значения которого вычисляются по формуле.
Вычисляемые поля позволяют вам создавать новые измерения и показатели. При этом источник данных не изменяется.

Для записи формул вы можете использовать существующие поля датасета, [параметры](../parameters.md), константы и [функции](#functions).

Вы можете [создавать](#how-to-create-calculated-field) вычисляемые поля в интерфейсе датасета или визарда:

* Вычисляемые поля из датасета доступны во всех чартах над этим датасетом.
* Вычисляемые поля из визарда доступны только для сохраненного чарта.

Вычисляемые поля помечаются значком ![image](../../../_assets/console-icons/function.svg).

## Вычисляемые поля в датасете {#dataset}

Вы можете добавлять новые поля в список полей датасета.

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

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

Чтобы поля не отображались в визарде, при создании включите опцию **Не показывать в визарде**.

## Вычисляемые поля в чарте {#chart}

Вы можете добавлять новые поля при создании и редактировании чарта в визарде:

* в списке полей из датасета;
* в секции визуализации.

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

Если поле создано в чарте, то оно не будет доступно для селекторов дашборда и других чартов.

{% note warning %}

В [мультидатасетных чартах](../chart/index.md#multi-dataset-charts) вычисляемые поля над полями из нескольких датасетов неприменимы.

{% endnote %}

## Функции {#functions}

Функции — основной компонент создания формул. Они позволяют выполнять различные операции над полями данных.

Список доступных функций зависит от источника данных. Подробнее в разделе [Поддержка функций](../../function-ref/availability.md).

{% note warning %}

Избегайте зацикливания вычислений: в формуле нельзя использовать поле, которое использует эту же формулу для вычисления своего значения.

{% endnote %}

### Формат записи {#entry-format}

Формулы записываются с учетом следующих требований:

1. Указывайте аргументы функций в круглых скобках. Например, `YEAR([DATE1])`. Несколько аргументов разделяются запятой.
1. Записывайте имена полей в квадратных скобках. Например, `[CustomerID]`.
1. Записывайте значения полей и констант в допустимом [формате](../../dataset/data-types.md). Например, используйте точку в качестве разделителя для дробных чисел: `0.123`.

{% note info %}

* Синтаксис имен полей регистрозависимый. Например, если в формуле используется `[NAME]`, а в датасете есть только `[Name]`, поле в формуле будет подсвечено красным.
* Синтаксис функций регистронезависимый. Например, `count` и `COUNT` выполнят одну и ту же операцию.

{% endnote %}

Справочная информация по формату, типам принимаемых аргументов, а также возвращаемым значениям функций доступны в интерфейсе редактора формул. Для этого нажмите кнопку **Справочник** в интерфейсе добавления поля.

## Как создать вычисляемое поле {#how-to-create-calculated-field}

Вы можете создать вычисляемое поле в интерфейсе датасета или визарда.

{% list tabs %}

- Датасет

  {% note warning %}
  
  Если вы работаете с новой объектной моделью DataLens, включающей [воркбуки и коллекции](../../workbooks-collections/index.md):
  
  1. На панели слева выберите ![collections](../../../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**.
  1. Откройте нужный воркбук и выберите объект.
  
  Продолжайте инструкцию с шага 2.
  
  {% endnote %}
  
  
  1. На панели слева нажмите ![image](../../../_assets/console-icons/circles-intersection.svg) **Датасеты** и выберите нужный датасет. Если у вас нет датасета, [создайте его](../../dataset/create-dataset.md#create).
  1. В правом верхнем углу нажмите **![image](../../../_assets/console-icons/plus.svg) Добавить поле**.
  1. Введите название поля.
  1. Выберите **Формула** в качестве источника данных для поля.
  1. Введите формулу, используя [функции источника данных](../../function-ref/all.md).
  1. Нажмите кнопку **Создать**. Поле отобразится в датасете.

  ![dataset-calculated-field](../../../_assets/datalens/concepts/dataset-calculated-field.png)

- Визард
  
  
  {% note warning %}
  
  Если вы работаете с новой объектной моделью DataLens, включающей [воркбуки и коллекции](../../workbooks-collections/index.md):
  
  1. На панели слева выберите ![collections](../../../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**.
  1. Откройте нужный воркбук и выберите объект.
  
  Продолжайте инструкцию с шага 2.
  
  {% endnote %}


  1. На панели слева нажмите ![image](../../../_assets/console-icons/chart-column.svg) **Чарты** и выберите чарт, созданный в [визарде](https://datalens.ru/wizard).
  1. В левой части экрана над списком полей датасета нажмите значок ![image](../../../_assets/console-icons/plus.svg) и выберите **Поле**.
  1. Введите название поля.
  1. Введите необходимую формулу.
  1. Нажмите кнопку **Создать**. Поле отобразится в списке слева. Вы можете использовать его в чарте.

  ![chart-calculated-field](../../../_assets/datalens/concepts/chart-calculated-field.png)

  Также вы можете [продублировать](../../dataset/create-dataset.md#dublicate-fields) любое поле датасета, в том числе вычисляемое поле, которое вы создали ранее.

{% endlist %}

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

* [Создать поля](../../dataset/create-dataset.md#create-fields)
* [Управление доступом на уровне строк данных (RLS)](../../security/row-level-security.md)