2017-12-11 12:07:26 +00:00
# Операторы
2017-10-25 05:27:09 +00:00
В с е операторы преобразуются в соответствующие функции на этапе парсинга запроса, с учётом их приоритетов и ассоциативности.
Далее будут перечислены группы операторов в порядке их приоритета (чем выше, тем раньше оператор связывается с о своими аргументами).
2017-12-11 12:07:26 +00:00
## Операторы доступа
2017-10-25 05:27:09 +00:00
`a[N]` - доступ к элементу массива, функция `arrayElement(a, N)` .
`a.N` - доступ к элементу кортежа, функция `tupleElement(a, N)` .
2017-12-11 12:07:26 +00:00
## Оператор числового отрицания
2017-10-25 05:27:09 +00:00
`-a` - функция `negate(a)` .
2017-12-11 12:07:26 +00:00
## Операторы умножения и деления
2017-10-25 05:27:09 +00:00
`a * b` - функция `multiply(a, b)`
`a / b` - функция `divide(a, b)`
`a % b` - функция `modulo(a, b)`
2017-12-11 12:07:26 +00:00
## Операторы сложения и вычитания
2017-10-25 05:27:09 +00:00
`a + b` - функция `plus(a, b)`
`a - b` - функция `minus(a, b)`
2017-12-11 12:07:26 +00:00
## Операторы сравнения
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)`
`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`
2017-12-11 12:07:26 +00:00
## Операторы для работы с множествами
2017-10-25 05:27:09 +00:00
2018-12-21 19:23:55 +00:00
*Смотрите раздел [Операторы IN ](select.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
2019-12-06 12:22:55 +00:00
### EXTRACT
2019-09-23 15:31:46 +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` указывается, какой фрагмент даты нужно получить. Доступные значения:
- `DAY` — День. Возможные значения: 1– 31.
- `MONTH` — Номер месяца. Возможные значения: 1– 12.
- `YEAR` — Год.
- `SECOND` — Секунда. Возможные значения: 0– 59.
- `MINUTE` — Минута. Возможные значения: 0– 59.
- `HOUR` — Час. Возможные значения: 0– 23.
Эти значения могут быть указаны также в нижнем регистре (`day`, `month` ).
В параметре `date` указывается исходная дата. Поддерживаются типы [Date ](../data_types/date.md ) и [DateTime ](../data_types/datetime.md ).
Примеры:
2019-09-23 15:31:46 +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` .
2019-09-23 15:31:46 +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;
```
2019-09-23 15:31:46 +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'));
```
2019-09-23 15:31:46 +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
2019-09-23 15:31:46 +00:00
```text
2019-04-10 18:58:42 +00:00
┌─OrderYear─┬─OrderMonth─┬─OrderDay─┬─OrderHour─┬─OrderMinute─┬─OrderSecond─┐
│ 2008 │ 10 │ 11 │ 13 │ 23 │ 44 │
└───────────┴────────────┴──────────┴───────────┴─────────────┴─────────────┘
```
2019-09-23 16:18:19 +00:00
Больше примеров приведено в [тестах ](https://github.com/ClickHouse/ClickHouse/blob/master/dbms/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}
Создаёт значение типа [Interval ](../data_types/special_data_types/interval.md ) которое должно использоваться в арифметических операциях с о значениями типов [Date ](../data_types/date.md ) и [DateTime ](../data_types/datetime.md ).
Типы интервалов:
- `SECOND`
- `MINUTE`
- `HOUR`
- `DAY`
- `WEEK`
- `MONTH`
- `QUARTER`
- `YEAR`
!!! warning "Внимание"
Интервалы различных типов нельзя объединять. Нельзя использовать выражения вида `INTERVAL 4 DAY 1 HOUR` . Вместо этого интервалы можно выразить в единицах меньших или равных наименьшей единице интервала, Например, `INTERVAL 25 HOUR` . Также можно выполнять последовательные операции как показано в примере ниже.
Пример:
```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))─┐
│ 2019-10-23 11:16:28 │ 2019-10-27 14:16:28 │
└─────────────────────┴────────────────────────────────────────────────────────┘
```
**Смотрите также**
- Тип данных [Interval ](../data_types/special_data_types/interval.md )
- Функции преобразования типов [toInterval ](functions/type_conversion_functions.md#function-tointerval )
2017-12-11 12:07:26 +00:00
## Оператор логического отрицания
2017-10-25 05:27:09 +00:00
`NOT a` - функция `not(a)`
2018-02-12 22:05:44 +00:00
## Оператор логического 'И'
2017-10-25 05:27:09 +00:00
`a AND b` - функция `and(a, b)`
2018-02-12 22:05:44 +00:00
## Оператор логического 'ИЛИ'
2017-10-25 05:27:09 +00:00
`a OR b` - функция `or(a, b)`
2017-12-11 12:07:26 +00:00
## Условный оператор
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
2018-07-27 13:00:01 +00:00
Условный оператор сначала вычисляет значения b и c, затем проверяет выполнение условия a, и только после этого возвращает соответствующее значение. Если в качестве b или с выступает функция [arrayJoin() ](functions/array_join.md#functions_arrayjoin ), то размножение каждой строки произойдет вне зависимости от условия а .
2017-10-25 05:27:09 +00:00
2018-12-21 19:23:55 +00:00
## Условное выражение {#operator_case}
2017-10-25 05:27:09 +00:00
2019-09-23 15:31:46 +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
2017-12-11 12:07:26 +00:00
## Оператор склеивания строк
2017-10-25 05:27:09 +00:00
`s1 || s2` - функция `concat(s1, s2)`
2017-12-11 12:07:26 +00:00
## Оператор создания лямбда-выражения
2017-10-25 05:27:09 +00:00
`x -> expr` - функция `lambda(x, expr)`
Следующие операторы не имеют приоритета, так как представляют собой скобки:
2017-12-11 12:07:26 +00:00
## Оператор создания массива
2017-10-25 05:27:09 +00:00
`[x1, ...]` - функция `array(x1, ...)`
2017-12-11 12:07:26 +00:00
## Оператор создания кортежа
2017-10-25 05:27:09 +00:00
`(x1, x2, ...)` - функция `tuple(x2, x2, ...)`
2017-12-11 12:07:26 +00:00
## Ассоциативность
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
2018-07-27 13:00:01 +00:00
## Проверка на `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
2018-12-12 17:28:00 +00:00
- Для значений типа [Nullable ](../data_types/nullable.md ) оператор `IS NULL` возвращает:
2018-07-04 06:21:21 +00:00
- `1` , если значение — `NULL` .
- `0` в обратном случае.
- Для прочих значений оператор `IS NULL` всегда возвращает `0` .
2019-09-23 15:31:46 +00:00
```sql
SELECT x+100 FROM t_null WHERE y IS NULL
```
```text
2018-07-04 06:21:21 +00:00
┌─plus(x, 100)─┐
│ 101 │
└──────────────┘
```
2018-07-17 05:48:14 +00:00
2018-07-04 06:21:21 +00:00
### IS NOT NULL
2018-12-12 17:28:00 +00:00
- Для значений типа [Nullable ](../data_types/nullable.md ) оператор `IS NOT NULL` возвращает:
2018-07-04 06:21:21 +00:00
- `0` , если значение — `NULL` .
- `1` , в обратном случае.
- Для прочих значений оператор `IS NOT NULL` всегда возвращает `1` .
2019-09-23 15:31:46 +00:00
```sql
SELECT * FROM t_null WHERE y IS NOT NULL
```
```text
2018-07-04 06:21:21 +00:00
┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘
```
2018-10-16 10:47:17 +00:00
[Оригинальная статья ](https://clickhouse.yandex/docs/ru/query_language/operators/ ) <!--hide-->