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

Операторы

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 │
└─────────────────────┴────────────────────────────────────────────────────────────┘
примечание

Синтаксис 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

Логический AND оператор​

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

Логический OR оператор​

Синтаксис 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.