Функции для работы с Nullable-аргументами

Функции для работы с Nullable-аргументами в RQL предназначены для управления и обработки данных, которые могут содержать NULL значения.

Набор поддерживаемых функций RQL и их поведение зависят от версии установленного ClickHouse. Если функция не поддерживается в используемой версии ClickHouse, она также не будет доступна в RQL.

Ознакомиться с актуальным списком функций и их поведением можно в официальной документации ClickHouse.

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

Функции для работы с Nullable-аргументами
Функция	Описание
`assumeNotNull(x)`	Убирает признак `Nullable` из типа значения `x`. Параметр `x` — значение типа `Nullable(T)`. Если значение `x` не равно `NULL`, функция возвращает это значение с типом `T` (без возможности хранить `NULL`). Если `x` равно `NULL`, результат не определен. Используйте функцию только тогда, когда заранее известно, что значение не может быть `NULL`.
`coalesce(x[, y, …])`	Возвращает первое значение из списка аргументов, которое не равно `NULL`. Параметр `x` — первый проверяемый аргумент. Параметры `y` и далее — необязательные дополнительные аргументы, которые последовательно проверяются, если предыдущие имеют значение `NULL`. Все аргументы должны иметь совместимые типы данных или приводиться к общему типу. Если все аргументы равны `NULL`, возвращает `NULL`.
`ifNull(x, alt)`	Заменяет `NULL` на указанное значение. Параметр `x` — проверяемое значение. Параметр `alt` — значение для замены. Аргументы должны иметь совместимые типы данных или приводиться к общему типу. Если `x` не равно `NULL`, функция возвращает `x`. Если `x` равно `NULL`, функция возвращает `alt`.
`isNotNull(x)`	Проверяет, что аргумент `x` не является значением `NULL`. Возвращает `1`, если `x` не равно `NULL`, иначе — `0`. Аналог оператора `IS NOT NULL`: `x IS NOT NULL`.
`isNull(x)`	Проверяет, является ли аргумент `x` значением `NULL`. Возвращает `1`, если `x` равно `NULL`, иначе — `0`. Аналог оператора `IS NULL`: `x IS NULL`.
`isNullable(x)`	Проверяет, имеет ли аргумент тип `Nullable`. Параметр `x` — значение или выражение любого типа. Возвращает `1`, если тип аргумента — `Nullable`, иначе — `0`.
`isZeroOrNull(x)`	Проверяет, является ли числовое значение `x` нулем (`0`) или `NULL`. Возвращает `1`, если `x` равно `0` или `NULL`, иначе — `0`.
`nullIf(x, y)`	Возвращает `NULL`, если аргументы `x` и `y` равны. В противном случае возвращает `x`. Аргументы должны иметь совместимые типы данных.
`toNullable(x)`	Преобразует тип аргумента `x` в `Nullable`. Входное значение `x` может быть любого типа. Возвращает значение `x` с типом `Nullable`.

Была ли полезна эта страница?

Обратная связь