ClickHouse/docs/ru/sql-reference/functions/conditional-functions.md
Alexey Boykov 1cd31382a5
Update conditional-functions.md
Fix typo.
2021-08-09 19:52:15 +03:00

3.8 KiB
Raw Blame History

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.

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

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 │
│                                       ᴺᵁᴸᴸ │
└────────────────────────────────────────────┘