Создать/управлять переменными | Manage Variables

Manage Variables создаёт одну или несколько переменных и меняет значения переменных, полученных из предыдущих нод. Например, здесь можно задать минимальную сумму продажи, регион и дату начала обработки, а затем использовать их в фильтре, SQL или Python.

Как создать переменную

  1. Добавьте в проект ноду Manage Variables и откройте её настройки.

  2. Добавьте переменную с именем min_amount.

  3. Выберите тип INT (целое число) и задайте значение 1000.

  4. В учебном примере оставьте nullable выключенным и задайте Default равным 0.

  5. Сохраните настройки.

  6. Соедините выход output_variables этой ноды со входом input_variables ноды-получателя.

Например, подключите переменные к Filter DataFrame и выберите min_amount справа в условии amount >=. Фильтр пропустит продажи с суммой от 1000 включительно. Если VARIABLE-порты скрыты, включите их отображение в контекстном меню ноды.

MANAGE-01

Manage Variables: min_amount типа INT, значение 1000, Default 0, nullable выключен.

Как задать несколько переменных

Добавьте в той же ноде отдельную запись для каждой переменной:

Имя

Тип

Значение

Для чего используется

min_amount

INT

1000

Минимальная сумма продажи

region

STRING

Москва

Нужный регион

organization_id

INT

10

Организация для обработки

Все эти переменные передаются через один выход output_variables. Создавать отдельную ноду для каждой независимой переменной не требуется.

Как изменить входную переменную

Подключите переменные предыдущей ноды ко входу input_variables. В Manage Variables добавьте запись с тем же именем и новым значением. Например, задайте min_amount = 1500, чтобы следующая ветка отбирала продажи от 1500.

На выходе одноимённая переменная получит новое значение. Остальные входные переменные также передаются дальше. Изменение действует для получателей этого выхода: сохранённые переменные проекта и другие ветки не изменяются.

Значения и выражения

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

Выражения в одной Manage Variables не используют другие переменные, которые вы создаёте в этой же ноде. Если новое значение зависит от только что созданной переменной, используйте две Manage Variables подряд и соедините их VARIABLE-порты.

Тип, пустое значение и Default

  • Тип определяет допустимые значения: INT — целые числа, FLOAT — дробные, STRING — текст, BOOLEAN — логические значения. Также доступны DATETIME, TIMEDELTA и JSON.

  • Список позволяет передавать несколько значений выбранного типа вместо одного.

  • nullable разрешает значение null, то есть отсутствие значения. Это не то же самое, что пустая строка или ноль.

  • Default задаёт запасное значение на случай, когда результат равен null. Оно должно соответствовать выбранному типу. Чтобы не задавать запасное значение, оставьте поле незаполненным.

В нашем примере значение переменной равно 1000. Default = 0 не меняет этот порог: ноль будет использован только вместо null. Запасное значение применяется прежде, чем проверяется nullable. Если Default не задан и nullable выключен, результат null приведёт к ошибке.

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

Как использовать результат

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

  • в SQL: {{ input_variables.min_amount }};

  • в фильтре: выбор min_amount в разделе «Переменные»;

  • в Python: input_variables["min_amount"] или input_variables.min_amount.

Manage Variables не создаёт переменную на уровне всего проекта. О настройке переменных проекта и примерах их использования читайте в руководстве по переменным.