mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-30 19:42:00 +00:00
320 lines
14 KiB
Markdown
320 lines
14 KiB
Markdown
---
|
||
toc_priority: 38
|
||
toc_title: "Операторы"
|
||
---
|
||
|
||
# Операторы {#operatory}
|
||
|
||
Все операторы преобразуются в соответствующие функции на этапе парсинга запроса, с учётом их приоритетов и ассоциативности.
|
||
Далее будут перечислены группы операторов в порядке их приоритета (чем выше, тем раньше оператор связывается со своими аргументами).
|
||
|
||
## Операторы доступа {#operatory-dostupa}
|
||
|
||
`a[N]` - доступ к элементу массива, функция `arrayElement(a, N)`.
|
||
|
||
`a.N` - доступ к элементу кортежа, функция `tupleElement(a, N)`.
|
||
|
||
## Оператор числового отрицания {#operator-chislovogo-otritsaniia}
|
||
|
||
`-a` - функция `negate(a)`.
|
||
|
||
## Операторы умножения и деления {#operatory-umnozheniia-i-deleniia}
|
||
|
||
`a * b` - функция `multiply(a, b)`
|
||
|
||
`a / b` - функция `divide(a, b)`
|
||
|
||
`a % b` - функция `modulo(a, b)`
|
||
|
||
## Операторы сложения и вычитания {#operatory-slozheniia-i-vychitaniia}
|
||
|
||
`a + b` - функция `plus(a, b)`
|
||
|
||
`a - b` - функция `minus(a, b)`
|
||
|
||
## Операторы сравнения {#operatory-sravneniia}
|
||
|
||
`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 ILIKE s` – функция `ilike(a, b)`
|
||
|
||
`a BETWEEN b AND c` - равнозначно `a >= b AND a <= c`
|
||
|
||
`a NOT BETWEEN b AND c` - равнозначно `a < b OR a > c`
|
||
|
||
## Операторы для работы с множествами {#operatory-dlia-raboty-s-mnozhestvami}
|
||
|
||
*Смотрите раздел [Операторы IN](../../sql-reference/operators/in.md#select-in-operators).*
|
||
|
||
`a IN ...` - функция `in(a, b)`
|
||
|
||
`a NOT IN ...` - функция `notIn(a, b)`
|
||
|
||
`a GLOBAL IN ...` - функция `globalIn(a, b)`
|
||
|
||
`a GLOBAL NOT IN ...` - функция `globalNotIn(a, b)`
|
||
|
||
## Оператор для работы с датами и временем {#operators-datetime}
|
||
|
||
### EXTRACT {#extract}
|
||
|
||
``` sql
|
||
EXTRACT(part FROM date);
|
||
```
|
||
|
||
Позволяет извлечь отдельные части из переданной даты. Например, можно получить месяц из даты, или минуты из времени.
|
||
|
||
В параметре `part` указывается, какой фрагмент даты нужно получить. Доступные значения:
|
||
|
||
- `DAY` — День. Возможные значения: 1–31.
|
||
- `MONTH` — Номер месяца. Возможные значения: 1–12.
|
||
- `YEAR` — Год.
|
||
- `SECOND` — Секунда. Возможные значения: 0–59.
|
||
- `MINUTE` — Минута. Возможные значения: 0–59.
|
||
- `HOUR` — Час. Возможные значения: 0–23.
|
||
|
||
Эти значения могут быть указаны также в нижнем регистре (`day`, `month`).
|
||
|
||
В параметре `date` указывается исходная дата. Поддерживаются типы [Date](../../sql-reference/data-types/date.md) и [DateTime](../../sql-reference/data-types/datetime.md).
|
||
|
||
Примеры:
|
||
|
||
``` sql
|
||
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`.
|
||
|
||
``` sql
|
||
CREATE TABLE test.Orders
|
||
(
|
||
OrderId UInt64,
|
||
OrderName String,
|
||
OrderDate DateTime
|
||
)
|
||
ENGINE = Log;
|
||
```
|
||
|
||
``` sql
|
||
INSERT INTO test.Orders VALUES (1, 'Jarlsberg Cheese', toDateTime('2008-10-11 13:23:44'));
|
||
```
|
||
|
||
``` sql
|
||
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;
|
||
```
|
||
|
||
``` text
|
||
┌─OrderYear─┬─OrderMonth─┬─OrderDay─┬─OrderHour─┬─OrderMinute─┬─OrderSecond─┐
|
||
│ 2008 │ 10 │ 11 │ 13 │ 23 │ 44 │
|
||
└───────────┴────────────┴──────────┴───────────┴─────────────┴─────────────┘
|
||
```
|
||
|
||
Больше примеров приведено в [тестах](https://github.com/ClickHouse/ClickHouse/blob/master/tests/queries/0_stateless/00619_extract.sql).
|
||
|
||
### INTERVAL {#operator-interval}
|
||
|
||
Создаёт значение типа [Interval](../../sql-reference/operators/index.md) которое должно использоваться в арифметических операциях со значениями типов [Date](../../sql-reference/operators/index.md) и [DateTime](../../sql-reference/operators/index.md).
|
||
|
||
Типы интервалов:
|
||
- `SECOND`
|
||
- `MINUTE`
|
||
- `HOUR`
|
||
- `DAY`
|
||
- `WEEK`
|
||
- `MONTH`
|
||
- `QUARTER`
|
||
- `YEAR`
|
||
|
||
В качестве значения оператора `INTERVAL` вы можете также использовать строковый литерал. Например, выражение `INTERVAL 1 HOUR` идентично выражению `INTERVAL '1 hour'` или `INTERVAL '1' hour`.
|
||
|
||
!!! 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))─┐
|
||
│ 2020-11-03 22:09:50 │ 2020-11-08 01:09:50 │
|
||
└─────────────────────┴────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
``` 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:12:10 │ 2020-11-08 01:12:10 │
|
||
└─────────────────────┴────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
``` 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 │
|
||
└─────────────────────┴────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
Вы можете изменить дату, не используя синтаксис `INTERVAL`, а просто добавив или отняв секунды, минуты и часы. Например, чтобы передвинуть дату на один день вперед, можно прибавить к ней значение `60*60*24`.
|
||
|
||
!!! note "Примечание"
|
||
Синтаксис `INTERVAL` или функция `addDays` предпочтительнее для работы с датами. Сложение с числом (например, синтаксис `now() + ...`) не учитывает региональные настройки времени, например, переход на летнее время.
|
||
|
||
Пример:
|
||
|
||
``` sql
|
||
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;
|
||
```
|
||
|
||
``` text
|
||
┌────────────────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](../../sql-reference/operators/index.md)
|
||
- Функции преобразования типов [toInterval](../../sql-reference/operators/index.md#function-tointerval)
|
||
|
||
## Оператор логического "И" {#logical-and-operator}
|
||
|
||
Синтаксис `SELECT a AND b` — вычисляет логическую конъюнкцию между `a` и `b` функцией [and](../../sql-reference/functions/logical-functions.md#logical-and-function).
|
||
|
||
## Оператор логического "ИЛИ" {#logical-or-operator}
|
||
|
||
Синтаксис `SELECT a OR b` — вычисляет логическую дизъюнкцию между `a` и `b` функцией [or](../../sql-reference/functions/logical-functions.md#logical-or-function).
|
||
|
||
## Оператор логического отрицания {#logical-negation-operator}
|
||
|
||
Синтаксис `SELECT NOT a` — вычисляет логическое отрицание `a` функцией [not](../../sql-reference/functions/logical-functions.md#logical-not-function).
|
||
|
||
## Оператор логического исключающего "ИЛИ" {#logical-xor-operator}
|
||
|
||
Синтаксис `SELECT a XOR b` — вычисляет логическую исключающую дизъюнкцию между `a` и `b` функцией [xor](../../sql-reference/functions/logical-functions.md#logical-xor-function).
|
||
|
||
## Условный оператор {#uslovnyi-operator}
|
||
|
||
`a ? b : c` - функция `if(a, b, c)`
|
||
|
||
Примечание:
|
||
|
||
Условный оператор сначала вычисляет значения b и c, затем проверяет выполнение условия a, и только после этого возвращает соответствующее значение. Если в качестве b или с выступает функция [arrayJoin()](../../sql-reference/operators/index.md#functions_arrayjoin), то размножение каждой строки произойдет вне зависимости от условия а.
|
||
|
||
## Условное выражение {#operator_case}
|
||
|
||
``` sql
|
||
CASE [x]
|
||
WHEN a THEN b
|
||
[WHEN ... THEN ...]
|
||
[ELSE c]
|
||
END
|
||
```
|
||
|
||
В случае указания `x` - функция `transform(x, [a, ...], [b, ...], c)`. Иначе — `multiIf(a, b, ..., c)`.
|
||
При отсутствии секции `ELSE c`, значением по умолчанию будет `NULL`.
|
||
|
||
!!! note "Примечание"
|
||
Функция `transform` не умеет работать с `NULL`.
|
||
|
||
## Оператор склеивания строк {#operator-skleivaniia-strok}
|
||
|
||
`s1 || s2` - функция `concat(s1, s2)`
|
||
|
||
## Оператор создания лямбда-выражения {#operator-sozdaniia-liambda-vyrazheniia}
|
||
|
||
`x -> expr` - функция `lambda(x, expr)`
|
||
|
||
Следующие операторы не имеют приоритета, так как представляют собой скобки:
|
||
|
||
## Оператор создания массива {#operator-sozdaniia-massiva}
|
||
|
||
`[x1, ...]` - функция `array(x1, ...)`
|
||
|
||
## Оператор создания кортежа {#operator-sozdaniia-kortezha}
|
||
|
||
`(x1, x2, ...)` - функция `tuple(x2, x2, ...)`
|
||
|
||
## Ассоциативность {#assotsiativnost}
|
||
|
||
Все бинарные операторы имеют левую ассоциативность. Например, `1 + 2 + 3` преобразуется в `plus(plus(1, 2), 3)`.
|
||
Иногда это работает не так, как ожидается. Например, `SELECT 4 > 3 > 2` выдаст 0.
|
||
|
||
Для эффективности, реализованы функции `and` и `or`, принимающие произвольное количество аргументов. Соответствующие цепочки операторов `AND` и `OR`, преобразуются в один вызов этих функций.
|
||
|
||
## Проверка на `NULL` {#proverka-na-null}
|
||
|
||
ClickHouse поддерживает операторы `IS NULL` и `IS NOT NULL`.
|
||
|
||
### IS NULL {#operator-is-null}
|
||
|
||
- Для значений типа [Nullable](../../sql-reference/operators/index.md) оператор `IS NULL` возвращает:
|
||
- `1`, если значение — `NULL`.
|
||
- `0` в обратном случае.
|
||
- Для прочих значений оператор `IS NULL` всегда возвращает `0`.
|
||
|
||
<!-- -->
|
||
|
||
``` sql
|
||
SELECT x+100 FROM t_null WHERE y IS NULL
|
||
```
|
||
|
||
``` text
|
||
┌─plus(x, 100)─┐
|
||
│ 101 │
|
||
└──────────────┘
|
||
```
|
||
|
||
### IS NOT NULL {#is-not-null}
|
||
|
||
- Для значений типа [Nullable](../../sql-reference/operators/index.md) оператор `IS NOT NULL` возвращает:
|
||
- `0`, если значение — `NULL`.
|
||
- `1`, в обратном случае.
|
||
- Для прочих значений оператор `IS NOT NULL` всегда возвращает `1`.
|
||
|
||
<!-- -->
|
||
|
||
``` sql
|
||
SELECT * FROM t_null WHERE y IS NOT NULL
|
||
```
|
||
|
||
``` text
|
||
┌─x─┬─y─┐
|
||
│ 2 │ 3 │
|
||
└───┴───┘
|
||
```
|