ClickHouse/docs/ru/sql-reference/functions/conditional-functions.md

toc_priority	toc_title
43	Условные функции

Условные функции

if

Условное выражение. В отличии от большинства систем, ClickHouse всегда считает оба выражения then и else.

Синтаксис

SELECT if(cond, then, else)

Если условие cond не равно нулю, то возвращается результат выражения then. Если условие cond равно нулю или является NULL, то результат выражения then пропускается и возвращается результат выражения else.

Аргументы

• cond – проверяемое условие. Может быть UInt8 или NULL.
• then – возвращается результат выражения, если условие cond истинно.
• else – возвращается результат выражения, если условие cond ложно.

Возвращаемые значения

Функция выполняет выражения then или else и возвращает его результат, в зависимости от того, было ли условие cond равно нулю или нет.

Пример

Запрос:

SELECT if(1, plus(2, 2), plus(2, 6));

Результат:

┌─plus(2, 2)─┐
│          4 │
└────────────┘

Запрос:

SELECT if(0, plus(2, 2), plus(2, 6));

Результат:

┌─plus(2, 6)─┐
│          8 │
└────────────┘

Тернарный оператор

Работает так же, как функция if.

Синтаксис: cond ? then : else

Возвращает then, если cond верно (больше нуля), в остальных случаях возвращает else.

• cond должно быть типа UInt8, then и else должны относиться к наименьшему общему типу.

• then и else могут быть NULL.

Смотрите также

• ifNotFinite.

multiIf

Позволяет более компактно записать оператор CASE в запросе.

multiIf(cond_1, then_1, cond_2, then_2...else)

Аргументы

• cond_N — условие, при выполнении которого функция вернёт then_N.
• then_N — результат функции при выполнении.
• else — результат функции, если ни одно из условий не выполнено.

Функция принимает 2N+1 параметров.

Возвращаемые значения

Функция возвращает одно из значений then_N или else, в зависимости от условий cond_N.

Пример

Рассмотрим таблицу

┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
│ 2 │    3 │
└───┴──────┘

Выполним запрос SELECT multiIf(isNull(y), x, y < 3, y, NULL) FROM t_null. Результат:

┌─multiIf(isNull(y), x, less(y, 3), y, NULL)─┐
│                                          1 │
│                                       ᴺᵁᴸᴸ │
└────────────────────────────────────────────┘