运算符 - ClickHouse Documentation

ClickHouse 会在解析查询时，根据运算符的优先级、先后顺序和结合性，将其转换为相应的函数。

访问运算符

a[N] – 访问数组元素。arrayElement(a, N) 函数。 a.N – 访问Tuple元素。tupleElement(a, N) 函数。

数值取负运算符

-a – negate(a) 函数。有关 Tuple 取负，请参见：tupleNegate。

乘法和除法运算符

a * b – multiply(a, b) 函数。如需将Tuple乘以数值，请参见 tupleMultiplyByNumber；如需计算标量积，请参见 dotProduct。 a / b – divide(a, b) 函数。如需将Tuple除以数值，请参见 tupleDivideByNumber。 a % b – modulo(a, b) 函数。

加法和减法运算符

a + b – plus(a, b) 函数。对于 Tuple 加法，请参见：tuplePlus。 a - b – minus(a, b) 函数。对于 Tuple 减法，请参见：tupleMinus。

比较运算符

equals 函数

a = b – 表示 equals(a, b) 函数。 a == b – 表示 equals(a, b) 函数。

notEquals 函数

a != b – 表示 notEquals(a, b) 函数。 a <> b – 表示 notEquals(a, b) 函数。

lessOrEquals 函数

a <= b – 即 lessOrEquals(a, b) 函数。

greaterOrEquals 函数

a >= b —— greaterOrEquals(a, b) 函数。

less 函数

a < b —— less(a, b) 函数。

greater 函数

a > b — greater(a, b) 函数。

like 函数

a LIKE b —— 即 like(a, b) 函数。

notLike 函数

a NOT LIKE b —— 即 notLike(a, b) 函数。

ilike 函数

a ILIKE b —— 即 ilike(a, b) 函数。

BETWEEN 函数

a BETWEEN b AND c – 等同于 a >= b AND a <= c。 a NOT BETWEEN b AND c – 等同于 a < b OR a > c。

`is not distinct from` 运算符 (`<=>`)

从 25.10 版本开始，你可以像使用其他运算符一样使用 <=>。在 25.10 之前，它只能用于 JOIN 表达式，例如：

CREATE TABLE a (x String) ENGINE = Memory;
INSERT INTO a VALUES ('ClickHouse');

SELECT * FROM a AS a1 JOIN a AS a2 ON a1.x <=> a2.x;

┌─x──────────┬─a2.x───────┐
│ ClickHouse │ ClickHouse │
└────────────┴────────────┘

<=> 运算符是对 NULL 安全的相等运算符，等价于 IS NOT DISTINCT FROM。它的行为与常规相等运算符 (=) 类似，但会将 NULL 值视为可比较的。两个 NULL 值会被视为相等，而 NULL 与任何非 NULL 值比较时，返回 0 (false) 而不是 NULL。

SELECT
  'ClickHouse' <=> NULL,
  NULL <=> NULL

┌─isNotDistinc⋯use', NULL)─┬─isNotDistinc⋯NULL, NULL)─┐
│                        0 │                        1 │
└──────────────────────────┴──────────────────────────┘

用于处理字符串的运算符

OVERLAY

OVERLAY(string PLACING replacement FROM offset) - overlay(string, replacement, offset) 函数。
OVERLAY(string PLACING replacement FROM offset FOR length) - overlay(string, replacement, offset, length) 函数。
OVERLAYUTF8(string PLACING replacement FROM offset) - overlayUTF8(string, replacement, offset) 函数。
OVERLAYUTF8(string PLACING replacement FROM offset FOR length) - overlayUTF8(string, replacement, offset, length) 函数。

用于处理数据集的运算符

请参阅 IN 运算符和 EXISTS 运算符。

in 函数

a IN ... —— in(a, b) 函数。

notIn 函数

a NOT IN ... —— notIn(a, b) 函数。

globalIn 函数

a GLOBAL IN ... — globalIn(a, b) 函数。

globalNotIn 函数

a GLOBAL NOT IN ... —— globalNotIn(a, b) 函数。

in 子查询函数

a = ANY (subquery) – 即 in(a, subquery) 函数。

notIn 子查询函数

a != ANY (subquery) —— 与 a NOT IN (SELECT singleValueOrNull(*) FROM subquery) 相同。

in 子查询函数

a = ALL (subquery) – 等同于 a IN (SELECT singleValueOrNull(*) FROM subquery)。

notIn 子查询函数

a != ALL (subquery) —— 即 notIn(a, subquery) 函数。示例带有 ALL 的查询：

Query

SELECT number AS a FROM numbers(10) WHERE a > ALL (SELECT number FROM numbers(3, 3));

Response

┌─a─┐
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘

带有 ANY 的查询：

Query

SELECT number AS a FROM numbers(10) WHERE a > ANY (SELECT number FROM numbers(3, 3));

Response

┌─a─┐
│ 4 │
│ 5 │
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘

日期和时间运算符

EXTRACT

EXTRACT(part FROM date);

从给定的日期中提取指定部分。例如，您可以从给定日期中提取月份，或从时间中提取秒。 part 参数指定要提取日期的哪个部分。可用值如下：

SECOND — 秒。可能的值：0–59。
MINUTE — 分钟。可能的值：0–59。
HOUR — 小时。可能的值：0–23。
DAY — 月中的第几天。可能的值：1–31。
WEEK — ISO 8601 周数。可能的值：1–53。
MONTH — 月份编号。可能的值：1–12。
QUARTER — 季度。可能的值：1–4。
YEAR — 年。
EPOCH — Unix 时间戳 (自 1970-01-01 00:00:00 UTC 起的秒数) 。注意：对于 DateTime64，秒以下部分会被截断。
DOW — 一周中的第几天 (与 PostgreSQL 兼容) 。0 = 星期日，6 = 星期六。
DOY — 一年中的第几天。可能的值：1–366。
ISODOW — ISO 一周中的第几天。1 = 星期一，7 = 星期日。
ISOYEAR — ISO 8601 周编号年份。
CENTURY — 世纪。例如，2024 年属于 21 世纪。
DECADE — 十年 (年份除以 10) 。例如，2024 年的十年值为 202。
MILLENNIUM — 千年。例如，2024 年属于第 3 个千年。

part 参数不区分大小写。 date 参数指定要处理的日期或时间。支持 Date、Date32、DateTime 和 DateTime64 类型。示例：

SELECT EXTRACT(DAY FROM toDate('2017-06-15'));
SELECT EXTRACT(MONTH FROM toDate('2017-06-15'));
SELECT EXTRACT(YEAR FROM toDate('2017-06-15'));
SELECT EXTRACT(EPOCH FROM toDateTime('2024-01-15 12:30:45', 'UTC'));
SELECT EXTRACT(DOW FROM toDate('2024-01-15'));
SELECT EXTRACT(CENTURY FROM toDate('2024-01-01'));

在以下示例中，我们将创建一个表，并向其中插入一个 DateTime 类型的值。

CREATE TABLE test.Orders
(
    OrderId UInt64,
    OrderName String,
    OrderDate DateTime
) ENGINE = MergeTree
ORDER BY ();

INSERT INTO test.Orders VALUES (1, 'Jarlsberg Cheese', toDateTime('2008-10-11 13:23:44'));

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;

┌─OrderYear─┬─OrderMonth─┬─OrderDay─┬─OrderHour─┬─OrderMinute─┬─OrderSecond─┐
│      2008 │         10 │       11 │        13 │          23 │          44 │
└───────────┴────────────┴──────────┴───────────┴─────────────┴─────────────┘

你可以在 tests 中查看更多示例。

INTERVAL

创建一个 Interval 类型的值，用于与 Date 和 DateTime 类型的值进行算术运算。时间间隔类型：

SECOND
MINUTE
HOUR
DAY
WEEK
MONTH
QUARTER
YEAR

设置 INTERVAL 值时，也可以使用字符串字面量。例如，INTERVAL 1 HOUR 与 INTERVAL '1 hour' 或 INTERVAL '1' hour 完全等价。

不同类型的时间间隔不能组合使用。不能使用 INTERVAL 4 DAY 1 HOUR 这样的表达式。请使用小于或等于该时间间隔最小单位的单位来指定时间间隔，例如 INTERVAL 25 HOUR。你也可以像下面的示例那样，连续使用多个运算。

示例：

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY + INTERVAL 3 HOUR;

┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:09:50 │                                    2020-11-08 01:09:50 │
└─────────────────────┴────────────────────────────────────────────────────────┘

SELECT now() AS current_date_time, current_date_time + INTERVAL '4 day' + INTERVAL '3 hour';

┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:12:10 │                                    2020-11-08 01:12:10 │
└─────────────────────┴────────────────────────────────────────────────────────┘

SELECT now() AS current_date_time, current_date_time + INTERVAL '4' day + INTERVAL '3' hour;

┌───current_date_time─┬─plus(plus(now(), toIntervalDay('4')), toIntervalHour('3'))─┐
│ 2020-11-03 22:33:19 │                                        2020-11-08 01:33:19 │
└─────────────────────┴────────────────────────────────────────────────────────────┘

始终建议优先使用 INTERVAL 语法或 addDays 函数。简单的加减运算 (如 now() + ... 这样的写法) 不会考虑时间设置，例如夏令时。

示例：

SELECT toDateTime('2014-10-26 00:00:00', 'Asia/Istanbul') AS time, time + 60 * 60 * 24 AS time_plus_24_hours, time + toIntervalDay(1) AS time_plus_1_day;

┌────────────────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 数据类型
toInterval 类型转换函数

日期与时间相加

可以使用 + 运算符将 Date 或 Date32 值与 Time 或 Time64 值相加。结果为 DateTime 或 DateTime64，表示该日期中给定时刻的日期时间值。该运算满足交换律。结果类型取决于操作数类型：

Left operand	Right operand	Result type
`Date`	`Time`	`DateTime`
`Date`	`Time64(s)`	`DateTime64(s)`
`Date32`	`Time`	`DateTime64(0)`
`Date32`	`Time64(s)`	`DateTime64(s)`

结果使用会话时区 (如果未设置会话时区，则使用服务器默认时区) 。date_time_overflow_behavior设置控制结果超出可表示范围时的行为。

示例：

SET use_legacy_to_time = 0;
SELECT toDate('2024-07-15') + toTime('14:30:25') AS dt, toTypeName(dt);

┌──────────────────dt─┬─toTypeName(dt)─┐
│ 2024-07-15 14:30:25 │ DateTime       │
└─────────────────────┴────────────────┘

SELECT toDate('2024-07-15') + toTime64('14:30:25.123456', 6) AS dt, toTypeName(dt);

┌─────────────────────────dt─┬─toTypeName(dt)─┐
│ 2024-07-15 14:30:25.123456 │ DateTime64(6)  │
└────────────────────────────┴────────────────┘

SELECT toTime64('23:59:59.999', 3) + toDate32('2024-07-15') AS dt, toTypeName(dt);

┌──────────────────────dt─┬─toTypeName(dt)─┐
│ 2024-07-15 23:59:59.999 │ DateTime64(3)  │
└─────────────────────────┴────────────────┘

逻辑 AND 运算符

语法 SELECT a AND b — 使用函数 and 计算 a 与 b 的逻辑与。

逻辑 OR 运算符

语法 SELECT a OR b — 使用函数 or 计算 a 与 b 的逻辑或。

逻辑非运算符

语法 SELECT NOT a — 使用函数 not 对 a 进行逻辑非运算。

条件运算符

a ? b : c – if(a, b, c) 函数。注意：条件运算符会先计算 b 和 c 的值，再检查是否满足条件 a，然后返回对应的值。如果 b 或 C 是 arrayJoin() 函数，则无论 “a” 条件是否成立，每一行都会被复制。

条件表达式

CASE [x]
    WHEN a THEN b
    [WHEN ... THEN ...]
    [ELSE c]
END

如果指定了 x，则使用 transform(x, [a, ...], [b, ...], c) 函数。否则，使用 multiIf(a, b, ..., c)。如果表达式中没有 ELSE c 子句，默认值为 NULL。 transform 函数不支持 NULL。

拼接运算符

s1 || s2 – concat(s1, s2) 函数。

Lambda 创建运算符

x -> expr – lambda(x, expr) 函数。以下运算符没有优先级，因为它们是括号：

数组创建运算符

[x1, ...] – array(x1, ...) 函数。

Tuple 创建运算符

(x1, x2, ...) – 即 tuple(x2, x2, ...) 函数。

结合性

所有二元运算符都是左结合的。例如，1 + 2 + 3 会被转换为 plus(plus(1, 2), 3)。但有时结果可能不符合你的预期。例如，SELECT 4 > 2 > 3 的结果将为 0。出于效率考虑，and 和 or 函数可以接受任意数量的参数。相应的 AND 和 OR 运算符链会被转换为对这些函数的一次调用。

检查 `NULL` 值

ClickHouse 支持 IS NULL 和 IS NOT NULL 运算符。

IS NULL

对于 Nullable 类型的值，IS NULL 运算符返回：
- 如果值为 NULL，则返回 1。
- 否则返回 0。
对于其他值，IS NULL 运算符始终返回 0。

可通过启用 optimize_functions_to_subcolumns 设置来优化。将 optimize_functions_to_subcolumns = 1 时，该函数只会读取 null 子列，而不是读取并处理整个列数据。查询 SELECT n IS NULL FROM table 会被转换为 SELECT n.null FROM TABLE。

SELECT x+100 FROM t_null WHERE y IS NULL

┌─plus(x, 100)─┐
│          101 │
└──────────────┘

IS NOT NULL

对于 Nullable 类型的值，IS NOT NULL 运算符返回：
- 如果该值为 NULL，则返回 0。
- 否则返回 1。
对于其他值，IS NOT NULL 运算符始终返回 1。

SELECT * FROM t_null WHERE y IS NOT NULL

┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘

可通过启用 optimize_functions_to_subcolumns 设置进行优化。将 optimize_functions_to_subcolumns = 1 时，该函数仅读取 null 子列，而不是读取并处理整个列数据。查询 SELECT n IS NOT NULL FROM table 会被转换为 SELECT NOT n.null FROM TABLE。

​访问运算符

​数值取负运算符

​乘法和除法运算符

​加法和减法运算符

​比较运算符

​equals 函数

​notEquals 函数

​lessOrEquals 函数

​greaterOrEquals 函数

​less 函数

​greater 函数

​like 函数

​notLike 函数

​ilike 函数

​BETWEEN 函数

​is not distinct from 运算符 (<=>)

​用于处理字符串的运算符

​OVERLAY

​用于处理数据集的运算符

​in 函数

​notIn 函数

​globalIn 函数

​globalNotIn 函数

​in 子查询函数

​notIn 子查询函数

​in 子查询函数

​notIn 子查询函数

​日期和时间运算符

​EXTRACT

​INTERVAL

​日期与时间相加

​逻辑 AND 运算符

​逻辑 OR 运算符

​逻辑非运算符

​条件运算符

​条件表达式

​拼接运算符

​Lambda 创建运算符

​数组创建运算符

​Tuple 创建运算符

​结合性

​检查 NULL 值

​IS NULL

​IS NOT NULL

访问运算符

数值取负运算符

乘法和除法运算符

加法和减法运算符

比较运算符

equals 函数

notEquals 函数

lessOrEquals 函数

greaterOrEquals 函数

less 函数

greater 函数

like 函数

notLike 函数

ilike 函数

BETWEEN 函数

`is not distinct from` 运算符 (`<=>`)

用于处理字符串的运算符

OVERLAY

用于处理数据集的运算符

in 函数

notIn 函数

globalIn 函数

globalNotIn 函数

in 子查询函数

notIn 子查询函数

in 子查询函数

notIn 子查询函数

日期和时间运算符

EXTRACT

INTERVAL

日期与时间相加

逻辑 AND 运算符

逻辑 OR 运算符

逻辑非运算符

条件运算符

条件表达式

拼接运算符

Lambda 创建运算符

数组创建运算符

Tuple 创建运算符

结合性

检查 `NULL` 值

IS NULL

IS NOT NULL