2020-10-26 10:29:30 +00:00
---
toc_priority: 38
2021-03-08 14:54:44 +00:00
toc_title: "Операторы"
2020-10-26 10:29:30 +00:00
---
2020-03-20 18:20:59 +00:00
# Операторы {#operatory}
2017-10-25 05:27:09 +00:00
В с е операторы преобразуются в соответствующие функции на этапе парсинга запроса, с учётом их приоритетов и ассоциативности.
Далее будут перечислены группы операторов в порядке их приоритета (чем выше, тем раньше оператор связывается с о своими аргументами).
2020-03-20 18:20:59 +00:00
## Операторы доступа {#operatory-dostupa}
2017-10-25 05:27:09 +00:00
`a[N]` - доступ к элементу массива, функция `arrayElement(a, N)` .
`a.N` - доступ к элементу кортежа, функция `tupleElement(a, N)` .
2020-03-20 18:20:59 +00:00
## Оператор числового отрицания {#operator-chislovogo-otritsaniia}
2017-10-25 05:27:09 +00:00
`-a` - функция `negate(a)` .
2021-10-25 11:13:12 +00:00
Для чисел в кортеже также может быть использована [tupleNegate ](../../sql-reference/functions/tuple-functions.md#tuplenegate ).
2021-10-22 18:05:31 +00:00
2020-03-20 18:20:59 +00:00
## Операторы умножения и деления {#operatory-umnozheniia-i-deleniia}
2017-10-25 05:27:09 +00:00
`a * b` - функция `multiply(a, b)`
2021-10-25 11:13:12 +00:00
Для умножения кортежа на число также может быть использована [tupleMultiplyByNumber ](../../sql-reference/functions/tuple-functions.md#tuplemultiplybynumber ), для скалярного произведения: [dotProduct ](../../sql-reference/functions/tuple-functions.md#dotproduct ).
2021-10-22 18:05:31 +00:00
2017-10-25 05:27:09 +00:00
`a / b` - функция `divide(a, b)`
2021-10-25 11:13:12 +00:00
Для деления кортежа на число также может быть использована [tupleDivideByNumber ](../../sql-reference/functions/tuple-functions.md#tupledividebynumber ).
2021-10-22 18:05:31 +00:00
2017-10-25 05:27:09 +00:00
`a % b` - функция `modulo(a, b)`
2020-03-20 18:20:59 +00:00
## Операторы сложения и вычитания {#operatory-slozheniia-i-vychitaniia}
2017-10-25 05:27:09 +00:00
`a + b` - функция `plus(a, b)`
2021-10-25 11:13:12 +00:00
Для сложения кортежей также может быть использована [tuplePlus ](../../sql-reference/functions/tuple-functions.md#tupleplus ).
2021-10-22 18:05:31 +00:00
2017-10-25 05:27:09 +00:00
`a - b` - функция `minus(a, b)`
2021-10-25 11:13:12 +00:00
Для вычитания кортежей также может быть использована [tupleMinus ](../../sql-reference/functions/tuple-functions.md#tupleminus ).
2021-10-22 18:05:31 +00:00
2020-03-20 18:20:59 +00:00
## Операторы сравнения {#operatory-sravneniia}
2017-10-25 05:27:09 +00:00
`a = b` - функция `equals(a, b)`
`a == b` - функция `equals(a, b)`
`a != b` - функция `notEquals(a, b)`
`a <> b` - функция `notEquals(a, b)`
`a <= b` - функция `lessOrEquals(a, b)`
`a >= b` - функция `greaterOrEquals(a, b)`
`a < b` - функция `less(a, b)`
`a > b` - функция `greater(a, b)`
`a LIKE s` - функция `like(a, b)`
`a NOT LIKE s` - функция `notLike(a, b)`
2020-10-19 15:32:09 +00:00
`a ILIKE s` – функция `ilike(a, b)`
2017-10-25 05:27:09 +00:00
`a BETWEEN b AND c` - равнозначно `a >= b AND a <= c`
2019-03-26 12:44:25 +00:00
`a NOT BETWEEN b AND c` - равнозначно `a < b OR a > c`
2020-03-20 18:20:59 +00:00
## Операторы для работы с множествами {#operatory-dlia-raboty-s-mnozhestvami}
2017-10-25 05:27:09 +00:00
2020-05-15 04:34:54 +00:00
*Смотрите раздел [Операторы IN ](../../sql-reference/operators/in.md#select-in-operators ).*
2017-10-25 05:27:09 +00:00
`a IN ...` - функция `in(a, b)`
`a NOT IN ...` - функция `notIn(a, b)`
`a GLOBAL IN ...` - функция `globalIn(a, b)`
`a GLOBAL NOT IN ...` - функция `globalNotIn(a, b)`
2021-10-26 17:10:30 +00:00
`a = ANY (subquery)` – функция `in(a, subquery)` .
2021-10-22 18:57:38 +00:00
2021-10-26 17:10:30 +00:00
`a != ANY (subquery)` – равнозначно `a NOT IN (SELECT singleValueOrNull(*) FROM subquery)` .
2021-10-22 18:57:38 +00:00
2021-10-26 17:10:30 +00:00
`a = ALL (subquery)` – равнозначно `a IN (SELECT singleValueOrNull(*) FROM subquery)` .
2021-10-22 18:57:38 +00:00
2021-10-26 17:10:30 +00:00
`a != ALL (subquery)` – функция `notIn(a, subquery)` .
2021-10-22 18:57:38 +00:00
**Примеры**
Запрос с ALL:
``` sql
SELECT number AS a FROM numbers(10) WHERE a > ALL (SELECT number FROM numbers(3, 3));
```
Результат:
``` text
┌─a─┐
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘
```
Запрос с ANY:
``` sql
SELECT number AS a FROM numbers(10) WHERE a > ANY (SELECT number FROM numbers(3, 3));
```
Результат:
``` text
┌─a─┐
│ 4 │
│ 5 │
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘
```
2019-08-14 16:42:09 +00:00
## Оператор для работы с датами и временем {#operators-datetime}
2019-04-10 18:58:42 +00:00
2020-03-20 18:20:59 +00:00
### EXTRACT {#extract}
2019-12-06 12:22:55 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-04-10 18:58:42 +00:00
EXTRACT(part FROM date);
```
2019-08-14 16:42:09 +00:00
Позволяет извлечь отдельные части из переданной даты. Например, можно получить месяц из даты, или минуты из времени.
2019-04-10 18:58:42 +00:00
В параметре `part` указывается, какой фрагмент даты нужно получить. Доступные значения:
2020-03-21 04:11:51 +00:00
- `DAY` — День. Возможные значения: 1– 31.
- `MONTH` — Номер месяца. Возможные значения: 1– 12.
- `YEAR` — Год.
- `SECOND` — Секунда. Возможные значения: 0– 59.
- `MINUTE` — Минута. Возможные значения: 0– 59.
- `HOUR` — Час. Возможные значения: 0– 23.
2019-04-10 18:58:42 +00:00
Эти значения могут быть указаны также в нижнем регистре (`day`, `month` ).
2020-05-15 04:34:54 +00:00
В параметре `date` указывается исходная дата. Поддерживаются типы [Date ](../../sql-reference/data-types/date.md ) и [DateTime ](../../sql-reference/data-types/datetime.md ).
2019-04-10 18:58:42 +00:00
Примеры:
2020-03-20 18:20:59 +00:00
``` sql
2019-04-10 18:58:42 +00:00
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` .
2020-03-20 18:20:59 +00:00
``` sql
2019-04-10 18:58:42 +00:00
CREATE TABLE test.Orders
(
2019-08-14 16:42:09 +00:00
OrderId UInt64,
OrderName String,
2019-04-10 18:58:42 +00:00
OrderDate DateTime
)
ENGINE = Log;
```
2020-03-20 18:20:59 +00:00
``` sql
2019-04-10 18:58:42 +00:00
INSERT INTO test.Orders VALUES (1, 'Jarlsberg Cheese', toDateTime('2008-10-11 13:23:44'));
```
2020-03-20 18:20:59 +00:00
``` sql
2019-08-14 16:42:09 +00:00
SELECT
toYear(OrderDate) AS OrderYear,
toMonth(OrderDate) AS OrderMonth,
toDayOfMonth(OrderDate) AS OrderDay,
toHour(OrderDate) AS OrderHour,
2019-04-10 18:58:42 +00:00
toMinute(OrderDate) AS OrderMinute,
toSecond(OrderDate) AS OrderSecond
FROM test.Orders;
2019-09-23 15:31:46 +00:00
```
2019-04-10 18:58:42 +00:00
2020-03-20 18:20:59 +00:00
``` text
2019-04-10 18:58:42 +00:00
┌─OrderYear─┬─OrderMonth─┬─OrderDay─┬─OrderHour─┬─OrderMinute─┬─OrderSecond─┐
│ 2008 │ 10 │ 11 │ 13 │ 23 │ 44 │
└───────────┴────────────┴──────────┴───────────┴─────────────┴─────────────┘
```
2020-04-01 23:51:21 +00:00
Больше примеров приведено в [тестах ](https://github.com/ClickHouse/ClickHouse/blob/master/tests/queries/0_stateless/00619_extract.sql ).
2019-04-10 18:58:42 +00:00
2019-12-06 12:22:55 +00:00
### INTERVAL {#operator-interval}
2020-05-15 04:34:54 +00:00
Создаёт значение типа [Interval ](../../sql-reference/operators/index.md ) которое должно использоваться в арифметических операциях с о значениями типов [Date ](../../sql-reference/operators/index.md ) и [DateTime ](../../sql-reference/operators/index.md ).
2019-12-06 12:22:55 +00:00
Типы интервалов:
- `SECOND`
- `MINUTE`
- `HOUR`
- `DAY`
- `WEEK`
- `MONTH`
- `QUARTER`
- `YEAR`
2020-11-05 21:44:56 +00:00
В качестве значения оператора `INTERVAL` вы можете также использовать строковый литерал. Например, выражение `INTERVAL 1 HOUR` идентично выражению `INTERVAL '1 hour'` или `INTERVAL '1' hour` .
2019-12-06 12:22:55 +00:00
!!! warning "Внимание"
Интервалы различных типов нельзя объединять. Нельзя использовать выражения вида `INTERVAL 4 DAY 1 HOUR` . Вместо этого интервалы можно выразить в единицах меньших или равных наименьшей единице интервала, Например, `INTERVAL 25 HOUR` . Также можно выполнять последовательные операции как показано в примере ниже.
2020-11-05 21:44:56 +00:00
Примеры:
``` sql
SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY + INTERVAL 3 HOUR;
```
``` text
┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:09:50 │ 2020-11-08 01:09:50 │
└─────────────────────┴────────────────────────────────────────────────────────┘
```
2019-12-06 12:22:55 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2020-11-05 21:44:56 +00:00
SELECT now() AS current_date_time, current_date_time + INTERVAL '4 day' + INTERVAL '3 hour';
2019-12-06 12:22:55 +00:00
```
2020-03-20 18:20:59 +00:00
``` text
2019-12-06 12:22:55 +00:00
┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
2020-11-05 21:44:56 +00:00
│ 2020-11-03 22:12:10 │ 2020-11-08 01:12:10 │
2019-12-06 12:22:55 +00:00
└─────────────────────┴────────────────────────────────────────────────────────┘
```
2020-11-05 21:44:56 +00:00
``` sql
SELECT now() AS current_date_time, current_date_time + INTERVAL '4' day + INTERVAL '3' hour;
```
``` text
┌───current_date_time─┬─plus(plus(now(), toIntervalDay('4')), toIntervalHour('3'))─┐
│ 2020-11-03 22:33:19 │ 2020-11-08 01:33:19 │
└─────────────────────┴────────────────────────────────────────────────────────────┘
```
2021-06-14 20:05:53 +00:00
Вы можете изменить дату, не используя синтаксис `INTERVAL` , а просто добавив или отняв секунды, минуты и часы. Например, чтобы передвинуть дату на один день вперед, можно прибавить к ней значение `60*60*24` .
2021-06-14 17:19:28 +00:00
!!! note "Примечание"
2021-07-29 15:20:55 +00:00
Синтаксис `INTERVAL` или функция `addDays` предпочтительнее для работы с датами. Сложение с числом (например, синтаксис `now() + ...` ) не учитывает региональные настройки времени, например, переход на летнее время.
2021-06-14 17:19:28 +00:00
Пример:
``` sql
2021-06-15 10:01:53 +00:00
SELECT toDateTime('2014-10-26 00:00:00', 'Europe/Moscow') AS time, time + 60 * 60 * 24 AS time_plus_24_hours, time + toIntervalDay(1) AS time_plus_1_day;
2021-06-14 17:19:28 +00:00
```
``` text
2021-06-15 09:58:51 +00:00
┌────────────────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 │
└─────────────────────┴─────────────────────┴─────────────────────┘
2021-06-14 17:19:28 +00:00
```
2019-12-06 12:22:55 +00:00
**Смотрите также**
2020-05-15 04:34:54 +00:00
- Тип данных [Interval ](../../sql-reference/operators/index.md )
- Функции преобразования типов [toInterval ](../../sql-reference/operators/index.md#function-tointerval )
2019-12-06 12:22:55 +00:00
2021-06-29 21:54:03 +00:00
## Оператор логического "И" {#logical-and-operator}
2017-10-25 05:27:09 +00:00
2021-06-29 21:02:45 +00:00
Синтаксис `SELECT a AND b` — вычисляет логическую конъюнкцию между `a` и `b` функцией [and ](../../sql-reference/functions/logical-functions.md#logical-and-function ).
2017-10-25 05:27:09 +00:00
2021-06-29 21:54:03 +00:00
## Оператор логического "ИЛИ" {#logical-or-operator}
2017-10-25 05:27:09 +00:00
2021-06-29 21:02:45 +00:00
Синтаксис `SELECT a OR b` — вычисляет логическую дизъюнкцию между `a` и `b` функцией [or ](../../sql-reference/functions/logical-functions.md#logical-or-function ).
2017-10-25 05:27:09 +00:00
2021-06-29 21:02:45 +00:00
## Оператор логического отрицания {#logical-negation-operator}
2017-10-25 05:27:09 +00:00
2021-06-29 21:02:45 +00:00
Синтаксис `SELECT NOT a` — вычисляет логическое отрицание `a` функцией [not ](../../sql-reference/functions/logical-functions.md#logical-not-function ).
2017-10-25 05:27:09 +00:00
2020-03-20 18:20:59 +00:00
## Условный оператор {#uslovnyi-operator}
2017-10-25 05:27:09 +00:00
`a ? b : c` - функция `if(a, b, c)`
2018-07-04 06:21:21 +00:00
Примечание:
2017-10-25 05:27:09 +00:00
2020-05-15 04:34:54 +00:00
Условный оператор сначала вычисляет значения b и c, затем проверяет выполнение условия a, и только после этого возвращает соответствующее значение. Если в качестве b или с выступает функция [arrayJoin() ](../../sql-reference/operators/index.md#functions_arrayjoin ), то размножение каждой строки произойдет вне зависимости от условия а .
2017-10-25 05:27:09 +00:00
2020-03-22 09:14:59 +00:00
## Условное выражение {#operator_case}
2017-10-25 05:27:09 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2017-10-25 05:27:09 +00:00
CASE [x]
WHEN a THEN b
[WHEN ... THEN ...]
2018-08-27 09:21:40 +00:00
[ELSE c]
2017-10-25 05:27:09 +00:00
END
```
2018-11-01 13:28:45 +00:00
В случае указания `x` - функция `transform(x, [a, ...], [b, ...], c)` . Иначе — `multiIf(a, b, ..., c)` .
При отсутствии секции `ELSE c` , значением по умолчанию будет `NULL` .
2019-04-11 15:18:55 +00:00
!!! note "Примечание"
Функция `transform` не умеет работать с `NULL` .
2017-10-25 05:27:09 +00:00
2020-03-20 18:20:59 +00:00
## Оператор склеивания строк {#operator-skleivaniia-strok}
2017-10-25 05:27:09 +00:00
`s1 || s2` - функция `concat(s1, s2)`
2020-03-20 18:20:59 +00:00
## Оператор создания лямбда-выражения {#operator-sozdaniia-liambda-vyrazheniia}
2017-10-25 05:27:09 +00:00
`x -> expr` - функция `lambda(x, expr)`
Следующие операторы не имеют приоритета, так как представляют собой скобки:
2020-03-20 18:20:59 +00:00
## Оператор создания массива {#operator-sozdaniia-massiva}
2017-10-25 05:27:09 +00:00
`[x1, ...]` - функция `array(x1, ...)`
2020-03-20 18:20:59 +00:00
## Оператор создания кортежа {#operator-sozdaniia-kortezha}
2017-10-25 05:27:09 +00:00
`(x1, x2, ...)` - функция `tuple(x2, x2, ...)`
2020-03-20 18:20:59 +00:00
## Ассоциативность {#assotsiativnost}
2017-10-25 05:27:09 +00:00
В с е бинарные операторы имеют левую ассоциативность. Например, `1 + 2 + 3` преобразуется в `plus(plus(1, 2), 3)` .
Иногда это работает не так, как ожидается. Например, `SELECT 4 > 3 > 2` выдаст 0.
Для эффективности, реализованы функции `and` и `or` , принимающие произвольное количество аргументов. Соответствующие цепочки операторов `AND` и `OR` , преобразуются в один вызов этих функций.
2018-07-04 06:21:21 +00:00
2020-03-20 18:20:59 +00:00
## Проверка на `NULL` {#proverka-na-null}
2018-07-04 06:21:21 +00:00
ClickHouse поддерживает операторы `IS NULL` и `IS NOT NULL` .
2018-12-21 19:23:55 +00:00
### IS NULL {#operator-is-null}
2018-07-04 06:21:21 +00:00
2020-05-15 04:34:54 +00:00
- Для значений типа [Nullable ](../../sql-reference/operators/index.md ) оператор `IS NULL` возвращает:
2020-03-21 04:11:51 +00:00
- `1` , если значение — `NULL` .
- `0` в обратном случае.
- Для прочих значений оператор `IS NULL` всегда возвращает `0` .
2018-07-04 06:21:21 +00:00
2021-06-29 13:27:54 +00:00
Оператор можно оптимизировать, если включить настройку [optimize_functions_to_subcolumns ](../../operations/settings/settings.md#optimize-functions-to-subcolumns ). При `optimize_functions_to_subcolumns = 1` читается только подстолбец [null ](../../sql-reference/data-types/nullable.md#finding-null ) вместо чтения и обработки данных всего столбца. Запрос `SELECT n IS NULL FROM table` преобразуется к запросу `SELECT n.null FROM TABLE` .
2021-06-26 23:37:34 +00:00
2020-03-20 18:20:59 +00:00
<!-- -->
``` sql
2019-09-23 15:31:46 +00:00
SELECT x+100 FROM t_null WHERE y IS NULL
```
2020-03-20 18:20:59 +00:00
``` text
2018-07-04 06:21:21 +00:00
┌─plus(x, 100)─┐
│ 101 │
└──────────────┘
```
2020-03-20 18:20:59 +00:00
### IS NOT NULL {#is-not-null}
2018-07-04 06:21:21 +00:00
2020-05-15 04:34:54 +00:00
- Для значений типа [Nullable ](../../sql-reference/operators/index.md ) оператор `IS NOT NULL` возвращает:
2020-03-21 04:11:51 +00:00
- `0` , если значение — `NULL` .
- `1` , в обратном случае.
- Для прочих значений оператор `IS NOT NULL` всегда возвращает `1` .
2018-07-04 06:21:21 +00:00
2021-06-29 13:27:54 +00:00
Оператор можно оптимизировать, если включить настройку [optimize_functions_to_subcolumns ](../../operations/settings/settings.md#optimize-functions-to-subcolumns ). При `optimize_functions_to_subcolumns = 1` читается только подстолбец [null ](../../sql-reference/data-types/nullable.md#finding-null ) вместо чтения и обработки данных всего столбца. Запрос `SELECT n IS NOT NULL FROM table` преобразуется к запросу `SELECT NOT n.null FROM TABLE` .
2021-06-26 23:37:34 +00:00
2020-03-20 18:20:59 +00:00
<!-- -->
``` sql
2019-09-23 15:31:46 +00:00
SELECT * FROM t_null WHERE y IS NOT NULL
```
2020-03-20 18:20:59 +00:00
``` text
2018-07-04 06:21:21 +00:00
┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘
```