---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/concepts/calculations/
  - ru/concepts/calculations/
  - href: ru/concepts/calculations/index.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/concepts/calculations/index.html
title: Вычисляемые поля в DataLens On-premises
description: >-
  Вычисляемое поле в DataLens On-premises — это дополнительное поле данных,
  значения которого вычисляются по формуле.
vcsPath: ru/concepts/calculations/index.md
---

# Вычисляемые поля в DataLens On-premises

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

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

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

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

Вычисляемые поля помечаются значком <!-- diplodoc:svg ![image](../../_assets/console-icons/function.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><g clip-path="url(#svg-xunx4um5__a)"><path fill="currentColor" fill-rule="evenodd" d="M4.312 4.29a.764.764 0 0 1 1.103-.62.75.75 0 1 0 .67-1.34 2.264 2.264 0 0 0-3.268 1.836L2.706 5.5H1.75a.75.75 0 0 0 0 1.5h.83l-.392 4.71a.764.764 0 0 1-1.103.62.75.75 0 0 0-.67 1.34 2.264 2.264 0 0 0 3.268-1.836L4.086 7H5.25a.75.75 0 1 0 0-1.5H4.21zm6.014 2.23a.75.75 0 0 0-1.152.96l.85 1.02-.85 1.02a.75.75 0 0 0 1.152.96L11 9.672l.674.808a.75.75 0 0 0 1.152-.96l-.85-1.02.85-1.02a.75.75 0 0 0-1.152-.96L11 7.328zM8.02 4.55a.75.75 0 0 1 .43.969l-.145.378a7.25 7.25 0 0 0 0 5.205l.145.378a.75.75 0 0 1-1.4.539l-.145-.378a8.75 8.75 0 0 1 0-6.282l.145-.378a.75.75 0 0 1 .97-.431m5.961 0a.75.75 0 0 1 .97.43l.145.379a8.75 8.75 0 0 1 0 6.282l-.146.378a.75.75 0 1 1-1.4-.538l.146-.379a7.25 7.25 0 0 0 0-5.205l-.146-.378a.75.75 0 0 1 .431-.97" clip-rule="evenodd"/></g><defs><clipPath id="svg-xunx4um5__a"><path fill="currentColor" d="M0 0h16v16H0z"/></clipPath></defs></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 %}

- Датасет

  <!-- source: ru/_includes/datalens/operations/datalens-create-calculated-field-in-dataset.md -->
  1. На панели слева нажмите <!-- diplodoc:svg ![image](../../_assets/console-icons/circles-intersection.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M6.576 11.854a4 4 0 1 1 0-7.707A5.48 5.48 0 0 0 5 8c0 1.5.601 2.861 1.576 3.854M8 12.9a5.5 5.5 0 1 1 0-9.8 5.5 5.5 0 1 1 0 9.8m1.424-8.754A4.003 4.003 0 0 1 14.5 8a4 4 0 0 1-5.076 3.854A5.48 5.48 0 0 0 11 8c0-1.5-.601-2.861-1.576-3.854M8 4.877C8.914 5.61 9.5 6.737 9.5 8s-.586 2.39-1.5 3.123A4 4 0 0 1 6.5 8c0-1.263.586-2.39 1.5-3.123" clip-rule="evenodd"/></svg> **Датасеты** и выберите нужный датасет. Если у вас нет датасета, [создайте его](../../dataset/create-dataset.md#create).
  1. В правом верхнем углу нажмите **<!-- diplodoc:svg ![image](../../_assets/console-icons/plus.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M8 1.75a.75.75 0 0 1 .75.75v4.75h4.75a.75.75 0 0 1 0 1.5H8.75v4.75a.75.75 0 0 1-1.5 0V8.75H2.5a.75.75 0 0 1 0-1.5h4.75V2.5A.75.75 0 0 1 8 1.75" clip-rule="evenodd"/></svg> Добавить поле**.
  1. Введите название поля.
  1. Выберите **Формула** в качестве источника данных для поля.
  1. Введите формулу, используя [функции источника данных](../../function-ref/all.md).
  1. Нажмите кнопку **Создать**. Поле отобразится в датасете.
  <!-- endsource: ru/_includes/datalens/operations/datalens-create-calculated-field-in-dataset.md -->

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

- Визард
  

  1. На панели слева нажмите <!-- diplodoc:svg ![image](../../_assets/console-icons/chart-column.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><g clip-path="url(#svg-f2gdncu8__a)"><path fill="currentColor" fill-rule="evenodd" d="M11.5 3.5h2a.5.5 0 0 1 .5.5v8a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1-.5-.5V4a.5.5 0 0 1 .5-.5m-2.5 9a.5.5 0 0 0 .5-.5V7a.5.5 0 0 0-.5-.5H7a.5.5 0 0 0-.5.5v5a.5.5 0 0 0 .5.5zm-4.5 0A.5.5 0 0 0 5 12v-2a.5.5 0 0 0-.5-.5h-2a.5.5 0 0 0-.5.5v2a.5.5 0 0 0 .5.5zm-1 1.5h-1a2 2 0 0 1-2-2v-2a2 2 0 0 1 2-2h2q.26 0 .5.063V7a2 2 0 0 1 2-2h2q.26 0 .5.063V4a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2z" clip-rule="evenodd"/></g><defs><clipPath id="svg-f2gdncu8__a"><path fill="currentColor" d="M0 0h16v16H0z"/></clipPath></defs></svg> **Чарты** и выберите чарт, созданный в [визарде](https://datalens.ru/wizard).
  1. В левой части экрана над списком полей датасета нажмите значок <!-- diplodoc:svg ![image](../../_assets/console-icons/plus.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M8 1.75a.75.75 0 0 1 .75.75v4.75h4.75a.75.75 0 0 1 0 1.5H8.75v4.75a.75.75 0 0 1-1.5 0V8.75H2.5a.75.75 0 0 1 0-1.5h4.75V2.5A.75.75 0 0 1 8 1.75" clip-rule="evenodd"/></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)