2017-12-28 15:13:23 +00:00
# Operators
All operators are transformed to the corresponding functions at the query parsing stage, in accordance with their precedence and associativity.
Groups of operators are listed in order of priority (the higher it is in the list, the earlier the operator is connected to its arguments).
2018-08-10 14:44:49 +00:00
## Access Operators
2017-12-28 15:13:23 +00:00
2018-12-25 15:25:43 +00:00
`a[N]` Access to an element of an array; ` arrayElement(a, N) function` .
2017-12-28 15:13:23 +00:00
`a.N` – Access to a tuble element; `tupleElement(a, N)` function.
2018-08-10 14:44:49 +00:00
## Numeric Negation Operator
2017-12-28 15:13:23 +00:00
`-a` – The `negate (a)` function.
2018-08-10 14:44:49 +00:00
## Multiplication and Division Operators
2017-12-28 15:13:23 +00:00
`a * b` – The `multiply (a, b) function.`
`a / b` – The ` divide(a, b) function.`
`a % b` – The `modulo(a, b) function.`
2018-08-10 14:44:49 +00:00
## Addition and Subtraction Operators
2017-12-28 15:13:23 +00:00
`a + b` – The `plus(a, b) function.`
`a - b` – The `minus(a, b) function.`
2018-08-10 14:44:49 +00:00
## Comparison Operators
2017-12-28 15:13:23 +00:00
`a = b` – The `equals(a, b) function.`
`a == b` – The ` equals(a, b) function.`
`a != b` – The `notEquals(a, b) function.`
`a <> b` – The `notEquals(a, b) function.`
`a <= b` – The `lessOrEquals(a, b) function.`
`a >= b` – The `greaterOrEquals(a, b) function.`
`a < b` – The `less(a, b) function.`
`a > b` – The `greater(a, b) function.`
`a LIKE s` – The `like(a, b) function.`
`a NOT LIKE s` – The `notLike(a, b) function.`
`a BETWEEN b AND c` – The same as `a >= b AND a <= c.`
2019-03-26 12:44:25 +00:00
`a NOT BETWEEN b AND c` – The same as `a < b OR a > c.`
2018-08-10 14:44:49 +00:00
## Operators for Working With Data Sets
2017-12-28 15:13:23 +00:00
2018-12-21 19:23:55 +00:00
*See the section [IN operators ](select.md#select-in-operators ).*
2017-12-28 15:13:23 +00:00
`a IN ...` – The `in(a, b) function`
`a NOT IN ...` – The `notIn(a, b) function.`
`a GLOBAL IN ...` – The `globalIn(a, b) function.`
`a GLOBAL NOT IN ...` – The `globalNotIn(a, b) function.`
2018-08-10 14:44:49 +00:00
## Logical Negation Operator
2017-12-28 15:13:23 +00:00
`NOT a` The `not(a) function.`
2018-08-10 14:44:49 +00:00
## Logical AND Operator
2017-12-28 15:13:23 +00:00
`a AND b` – The`and(a, b) function.`
2018-08-10 14:44:49 +00:00
## Logical OR Operator
2017-12-28 15:13:23 +00:00
`a OR b` – The `or(a, b) function.`
2018-08-10 14:44:49 +00:00
## Conditional Operator
2017-12-28 15:13:23 +00:00
`a ? b : c` – The `if(a, b, c) function.`
Note:
2018-09-04 11:18:59 +00:00
The conditional operator calculates the values of b and c, then checks whether condition a is met, and then returns the corresponding value. If `b` or `C` is an [arrayJoin() ](functions/array_join.md#functions_arrayjoin ) function, each row will be replicated regardless of the "a" condition.
2018-12-21 19:23:55 +00:00
## Conditional Expression {#operator_case}
2017-12-28 15:13:23 +00:00
2018-10-16 10:47:17 +00:00
``` sql
2017-12-28 15:13:23 +00:00
CASE [x]
WHEN a THEN b
[WHEN ... THEN ...]
2018-11-01 13:28:45 +00:00
[ELSE c]
2017-12-28 15:13:23 +00:00
END
```
2018-11-01 13:28:45 +00:00
If `x` is specified, then `transform(x, [a, ...], [b, ...], c)` function is used. Otherwise – `multiIf(a, b, ..., c)` .
If there is no `ELSE c` clause in the expression, the default value is `NULL` .
The `transform` function does not work with `NULL` .
2017-12-28 15:13:23 +00:00
2018-08-10 14:44:49 +00:00
## Concatenation Operator
2017-12-28 15:13:23 +00:00
`s1 || s2` – The `concat(s1, s2) function.`
2018-08-10 14:44:49 +00:00
## Lambda Creation Operator
2017-12-28 15:13:23 +00:00
`x -> expr` – The `lambda(x, expr) function.`
The following operators do not have a priority, since they are brackets:
2018-08-10 14:44:49 +00:00
## Array Creation Operator
2017-12-28 15:13:23 +00:00
`[x1, ...]` – The `array(x1, ...) function.`
2018-08-10 14:44:49 +00:00
## Tuple Creation Operator
2017-12-28 15:13:23 +00:00
`(x1, x2, ...)` – The `tuple(x2, x2, ...) function.`
## Associativity
All binary operators have left associativity. For example, `1 + 2 + 3` is transformed to `plus(plus(1, 2), 3)` .
2018-12-25 15:25:43 +00:00
Sometimes this doesn't work the way you expect. For example, ` SELECT 4 > 2 > 3` will result in 0.
2017-12-28 15:13:23 +00:00
For efficiency, the `and` and `or` functions accept any number of arguments. The corresponding chains of `AND` and `OR` operators are transformed to a single call of these functions.
2018-09-04 11:18:59 +00:00
## Checking for `NULL`
ClickHouse supports the `IS NULL` and `IS NOT NULL` operators.
2018-12-21 19:23:55 +00:00
### IS NULL {#operator-is-null}
2018-09-04 11:18:59 +00:00
2018-12-12 17:28:00 +00:00
- For [Nullable ](../data_types/nullable.md ) type values, the `IS NULL` operator returns:
2018-09-04 11:18:59 +00:00
- `1` , if the value is `NULL` .
- `0` otherwise.
- For other values, the `IS NULL` operator always returns `0` .
```bash
:) SELECT x+100 FROM t_null WHERE y IS NULL
SELECT x + 100
FROM t_null
WHERE isNull(y)
┌─plus(x, 100)─┐
│ 101 │
└──────────────┘
1 rows in set. Elapsed: 0.002 sec.
```
### IS NOT NULL
2018-12-12 17:28:00 +00:00
- For [Nullable ](../data_types/nullable.md ) type values, the `IS NOT NULL` operator returns:
2018-09-04 11:18:59 +00:00
- `0` , if the value is `NULL` .
- `1` otherwise.
- For other values, the `IS NOT NULL` operator always returns `1` .
```bash
:) SELECT * FROM t_null WHERE y IS NOT NULL
SELECT *
FROM t_null
WHERE isNotNull(y)
┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘
1 rows in set. Elapsed: 0.002 sec.
```
2018-10-16 10:47:17 +00:00
[Original article ](https://clickhouse.yandex/docs/en/query_language/operators/ ) <!--hide-->