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)` .
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)`
`a / b` - функция `divide(a, b)`
`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)`
`a - b` - функция `minus(a, b)`
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)`
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 │
└─────────────────────┴────────────────────────────────────────────────────────────┘
```
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
2020-03-20 18:20:59 +00:00
## Оператор логического отрицания {#operator-logicheskogo-otritsaniia}
2017-10-25 05:27:09 +00:00
`NOT a` - функция `not(a)`
2020-03-20 18:20:59 +00:00
## Оператор логического ‘И’ {#operator-logicheskogo-i}
2017-10-25 05:27:09 +00:00
`a AND b` - функция `and(a, b)`
2020-03-20 18:20:59 +00:00
## Оператор логического ‘ИЛИ’ {#operator-logicheskogo-ili}
2017-10-25 05:27:09 +00:00
`a OR b` - функция `or(a, b)`
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
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
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 │
└───┴───┘
```
2018-10-16 10:47:17 +00:00