Перейти к основному содержанию
Перейти к основному содержанию

Операторы

ClickHouse преобразует операторы в соответствующие функции на этапе разбора запроса в соответствии с их приоритетом, порядком вычисления и ассоциативностью.

Операторы доступа​

a[N] – Доступ к элементу массива. Функция arrayElement(a, N).

a.N – Доступ к элементу кортежа. Функция tupleElement(a, N).

Оператор числового отрицания​

-a – функция negate (a).

Для отрицания кортежей: tupleNegate.

Операторы умножения и деления​

a * b – функция multiply (a, b).

Для умножения кортежа на число используйте: tupleMultiplyByNumber, для скалярного произведения: dotProduct.

a / b – функция divide(a, b).

Для деления кортежа на число используйте: tupleDivideByNumber.

a % b – функция modulo(a, b).

Операторы сложения и вычитания​

a + b – функция plus(a, b).

Для сложения кортежей: tuplePlus.

a - b – функция minus(a, b).

Для вычитания кортежей: tupleMinus.

Операторы сравнения​

Функция equals​

a = b – функция equals(a, b).

a == b – функция equals(a, b).

Функция notEquals​

a != b – функция notEquals(a, b).

a <> b – функция notEquals(a, b).

Функция lessOrEquals​

a <= b – функция lessOrEquals(a, b).

Функция greaterOrEquals​

a >= b – функция greaterOrEquals(a, b).

Функция less​

a < b – функция less(a, b).

Функция greater​

a > b – функция greater(a, b).

Функция like​

a LIKE b – функция like(a, b).

Функция notLike​

a NOT LIKE b – функция notLike(a, b).

Функция ilike​

a ILIKE b – функция ilike(a, b).

Функция BETWEEN​

a BETWEEN b AND c – эквивалентно a >= b AND a <= c.

a NOT BETWEEN b AND c – эквивалентно a < b OR a > c.

Операторы для работы с наборами данных​

См. операторы IN и оператор EXISTS.

Функция in​

a IN ... — функция in(a, b).

Функция notIn​

a NOT IN ... — функция notIn(a, b).

Функция globalIn​

a GLOBAL IN ... — функция globalIn(a, b).

Функция globalNotIn​

a GLOBAL NOT IN ... — функция globalNotIn(a, b).

Функция in с подзапросом​

a = ANY (subquery) — функция in(a, subquery).

Функция notIn с подзапросом​

a != ANY (subquery) — эквивалентно a NOT IN (SELECT singleValueOrNull(*) FROM subquery).

Функция in с подзапросом​

a = ALL (subquery) — эквивалентно a IN (SELECT singleValueOrNull(*) FROM subquery).

Функция notIn с подзапросом​

a != ALL (subquery) — функция notIn(a, subquery).

Примеры

Запрос с ALL:

SELECT number AS a FROM numbers(10) WHERE a > ALL (SELECT number FROM numbers(3, 3));

Результат:

┌─a─┐
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘

Запрос с ANY:

SELECT number AS a FROM numbers(10) WHERE a > ANY (SELECT number FROM numbers(3, 3));

Результат:

┌─a─┐
│ 4 │
│ 5 │
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘

Операторы для работы с датами и временем​

EXTRACT​

EXTRACT(part FROM date);

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

Параметр part указывает, какую часть даты необходимо извлечь. Доступны следующие значения:

  • DAY — День месяца. Возможные значения: 1–31.
  • MONTH — Номер месяца. Возможные значения: 1–12.
  • YEAR — Год.
  • SECOND — Секунда. Возможные значения: 0–59.
  • MINUTE — Минута. Возможные значения: 0–59.
  • HOUR — Час. Возможные значения: 0–23.

Параметр part не чувствителен к регистру.

Параметр date указывает дату или время для обработки. Поддерживаются типы Date и DateTime.

Примеры:

SELECT EXTRACT(DAY FROM toDate('2017-06-15'));
SELECT EXTRACT(MONTH FROM toDate('2017-06-15'));
SELECT EXTRACT(YEAR FROM toDate('2017-06-15'));

В следующем примере создается таблица, и в неё вставляется значение типа DateTime.

CREATE TABLE test.Orders
(
    OrderId UInt64,
    OrderName String,
    OrderDate DateTime
)
ENGINE = Log;

INSERT INTO test.Orders VALUES (1, 'Jarlsberg Cheese', toDateTime('2008-10-11 13:23:44'));

SELECT
    toYear(OrderDate) AS OrderYear,
    toMonth(OrderDate) AS OrderMonth,
    toDayOfMonth(OrderDate) AS OrderDay,
    toHour(OrderDate) AS OrderHour,
    toMinute(OrderDate) AS OrderMinute,
    toSecond(OrderDate) AS OrderSecond
FROM test.Orders;

┌─OrderYear─┬─OrderMonth─┬─OrderDay─┬─OrderHour─┬─OrderMinute─┬─OrderSecond─┐
│      2008 │         10 │       11 │        13 │          23 │          44 │
└───────────┴────────────┴──────────┴───────────┴─────────────┴─────────────┘

Дополнительные примеры можно найти в тестах.

INTERVAL​

Создает значение типа Interval, которое используется в арифметических операциях со значениями типов Date и DateTime.

Типы интервалов:

  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR

При задании значения INTERVAL также можно использовать строковый литерал. Например, INTERVAL 1 HOUR идентично INTERVAL '1 hour' или INTERVAL '1' hour.

Совет

Интервалы разных типов нельзя комбинировать. Нельзя использовать выражения вида INTERVAL 4 DAY 1 HOUR. Указывайте интервалы в единицах, которые меньше или равны наименьшей единице интервала, например INTERVAL 25 HOUR. Можно использовать последовательные операции, как показано в примере ниже.

Примеры:

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY + INTERVAL 3 HOUR;

┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:09:50 │                                    2020-11-08 01:09:50 │
└─────────────────────┴────────────────────────────────────────────────────────┘

SELECT now() AS current_date_time, current_date_time + INTERVAL '4 day' + INTERVAL '3 hour';

┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:12:10 │                                    2020-11-08 01:12:10 │
└─────────────────────┴────────────────────────────────────────────────────────┘

SELECT now() AS current_date_time, current_date_time + INTERVAL '4' day + INTERVAL '3' hour;

┌───current_date_time─┬─plus(plus(now(), toIntervalDay('4')), toIntervalHour('3'))─┐
│ 2020-11-03 22:33:19 │                                        2020-11-08 01:33:19 │
└─────────────────────┴────────────────────────────────────────────────────────────┘

:::note
Синтаксис INTERVAL или функция addDays всегда предпочтительны. Простое сложение или вычитание (синтаксис вида now() + ...) не учитывает настройки временной зоны, например переход на летнее время. :::

Примеры:

SELECT toDateTime('2014-10-26 00:00:00', 'Asia/Istanbul') AS time, time + 60 * 60 * 24 AS time_plus_24_hours, time + toIntervalDay(1) AS time_plus_1_day;

┌────────────────time─┬──time_plus_24_hours─┬─────time_plus_1_day─┐
│ 2014-10-26 00:00:00 │ 2014-10-26 23:00:00 │ 2014-10-27 00:00:00 │
└─────────────────────┴─────────────────────┴─────────────────────┘

См. также

  • Interval — тип данных
  • toInterval — функции преобразования типов

Оператор логического И​

Синтаксис SELECT a AND b — вычисляет логическую конъюнкцию a и b с использованием функции and.

Оператор логического ИЛИ​

Синтаксис SELECT a OR b — вычисляет логическую дизъюнкцию a и b с помощью функции or.

Оператор логического отрицания​

Синтаксис SELECT NOT a — вычисляет логическое отрицание a с использованием функции not.

Условный оператор​

a ? b : c – функция if(a, b, c).

Примечание:

Условный оператор вычисляет значения b и c, затем проверяет выполнение условия a и возвращает соответствующее значение. Если b или c является функцией arrayJoin(), каждая строка будет реплицирована независимо от условия "a".

Условное выражение​

CASE [x]
    WHEN a THEN b
    [WHEN ... THEN ...]
    [ELSE c]
END

Если указан x, используется функция transform(x, [a, ...], [b, ...], c). В противном случае используется multiIf(a, b, ..., c).

Если в выражении отсутствует секция ELSE c, значение по умолчанию — NULL.

Функция transform не работает с NULL.

Оператор конкатенации​

s1 || s2 – функция concat(s1, s2).

Оператор создания лямбда-функции​

x -> expr – функция lambda(x, expr).

Следующие операторы не имеют приоритета, так как они являются скобками:

Оператор создания массива​

[x1, ...] – функция array(x1, ...).

Оператор создания кортежа​

(x1, x2, ...) — функция tuple(x2, x2, ...).

Ассоциативность​

Все бинарные операторы обладают левой ассоциативностью. Например, выражение 1 + 2 + 3 преобразуется в plus(plus(1, 2), 3). Иногда это работает не так, как ожидается. Например, запрос SELECT 4 > 2 > 3 вернёт 0.

Для повышения производительности функции and и or принимают любое количество аргументов. Соответствующие цепочки операторов AND и OR преобразуются в один вызов этих функций.

Проверка на NULL​

ClickHouse поддерживает операторы IS NULL и IS NOT NULL.

IS NULL​

  • Для значений типа Nullable оператор IS NULL возвращает:
    • 1, если значение равно NULL.
    • 0 в противном случае.
  • Для остальных значений оператор IS NULL всегда возвращает 0.

Может быть оптимизирован при включении настройки optimize_functions_to_subcolumns. При optimize_functions_to_subcolumns = 1 функция читает только подстолбец null вместо чтения и обработки данных всего столбца. Запрос SELECT n IS NULL FROM table преобразуется в SELECT n.null FROM TABLE.

SELECT x+100 FROM t_null WHERE y IS NULL

┌─plus(x, 100)─┐
│          101 │
└──────────────┘

IS NOT NULL​

  • Для значений типа Nullable оператор IS NOT NULL возвращает:
    • 0, если значение равно NULL.
    • 1 в противном случае.
  • Для остальных значений оператор IS NOT NULL всегда возвращает 1.
SELECT * FROM t_null WHERE y IS NOT NULL

┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘

Может быть оптимизирован при включении настройки optimize_functions_to_subcolumns. При optimize_functions_to_subcolumns = 1 функция читает только подстолбец null вместо чтения и обработки данных всего столбца. Запрос SELECT n IS NOT NULL FROM table преобразуется в SELECT NOT n.null FROM TABLE.