# Построение выражений

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

В построителе выражений перечислены элементы, доступные для текущей задачи. Справочные материалы по задачам перемещения охватывают задачи промежуточного хранения под управлением SaaS, промежуточного хранения в озере данных и репликации. Выражения хранилища, преобразования и витрин данных зависят от платформы данных или обработчика задач. Сведения о функциях CDC Storage и Streaming Transform см. в [Функции преобразования](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/transformation-functions.htm). Используйте функции и синтаксис, доступные в вашем редакторе.

## Создание или редактирование выражения

1. Откройте построитель выражений из столбца, правила преобразования или фильтра набора данных, которые вы настраиваете.

   Для выражения столбца нажмите the Изменить выражение столбца icon на столбце.

2. Выберите элемент, затем нажмите the Вставить выбранный элемент выражения icon, чтобы вставить его.

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

   Чтобы вставить оператор с панели инструментов, щелкните в том месте выражения, где он должен находиться, а затем щелкните оператор.

3. Замените заполнители аргументов функции параметрами столбцов, константами или вложенными выражениями.

   Заключайте текстовые константы и константы даты в одинарные кавычки, например `'Unknown'` и `'2026-10-08'`. Обозначайте вложенную кавычку двумя кавычками: `'O''Brien'`. Введите числа без кавычек, например `12` или `12.5`. Используйте `NULL` для отсутствующего значения, а не текст `'NULL'`.

4. Проверьте выражение, как описано ниже, затем нажмите ОК, чтобы сохранить его.

## Использование элементов выражений

* Столбцы: столбцы исходного набора данных предоставляют значения из обрабатываемой строки.

  Для задач потокового преобразования этот список также включает столбцы промежуточного хранения, такие как `hdr__kafka_partition` и `hdr__file_name`, в исходном порядке. Они отделены от заголовков `Q_H_` в выражениях задач перемещения. См. [Промежуточные таблицы](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/lakehouse-datasets-architecture-streaming.htm#Landing).

* Функции: вычисление или преобразование значений. Передавайте аргументы в порядке, указанном в сигнатуре функции. См. [Функции выражений](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-functions.htm).

  Примечание к информацииДля выражений Azure Synapse Analytics `$RTRIM` и `$LTRIM` удаляют только пробелы независимо от указанного символа усечения.

* Операторы: объединяют значения, сравнивают их или определяют условия. Используйте круглые скобки для управления порядком вычисления. См. [Операторы выражений](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-operators.htm).

* Заголовки: используйте метаданные изменений в задачах промежуточного хранения под управлением SaaS, промежуточного хранения в озере данных и репликации. Сведения о применимости конечной точки источника и значениях фазы обработки см. в [Заголовки выражений](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-headers.htm).

## Пример: объединение значений столбцов

Следующее выражение объединяет `first_file_name` и `first_file_title` через двоеточие:

```
${first_file_name} || ':' || ${first_file_title}
```

Для значений примера `sales` и `Sales June 2022` результатом является `sales:Sales June 2022`.

Редактирование выражения

Редактирование выражения

Редактирование выражения ![Редактор выражений, объединяющий два столбца набора данных через двоеточие.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_qdi_expression_editor.png)

## Тестирование выражений

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

Примечание к информацииТестирование вызовов функций `$SOURCE_LOOKUP` и `$TARGET_LOOKUP` не поддерживается.

1. Нажмите Извлечь параметры.

2. Введите Значение для проверки для каждого параметра, используя значения, соответствующие типу данных столбца.

3. Нажмите Проверить выражение и проверьте результат.

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