WHERE

WHERE 子句允许你过滤 SELECT 的 FROM 子句返回的数据。如果存在 WHERE 子句，其后必须跟一个 UInt8 类型的表达式。表达式求值结果为 0 的行会被排除，不再参与后续转换或最终结果。 WHERE 子句后的表达式通常会结合比较运算符和逻辑运算符使用，或者使用众多常规函数中的一种。如果底层表引擎支持，系统在计算 WHERE 表达式时会利用索引和分区裁剪能力。

PREWHERE还有一种名为 PREWHERE 的过滤优化。 Prewhere 是一种能更高效执行过滤的优化机制。即使未显式指定 PREWHERE 子句，它默认也是启用的。

判断 `NULL`

如果你需要判断某个值是否为 NULL，请使用：

IS NULL 或 isNull
IS NOT NULL 或 isNotNull

否则，包含 NULL 的表达式将永远不会成立。

使用逻辑运算符过滤数据

您可以将以下逻辑函数与 WHERE 子句配合使用，以组合多个条件：

and() 或 AND
not() 或 NOT
or() 或 NOT
xor()

将 UInt8 列用作条件

在 ClickHouse 中，UInt8 列可直接用作布尔条件，其中 0 表示 false，任何非零值 (通常为 1) 都表示 true。相关示例见下文。

使用比较运算符

可以使用以下比较运算符：

运算符	函数	描述	示例
`a = b`	`equals(a, b)`	等于	`price = 100`
`a == b`	`equals(a, b)`	等于 (替代语法)	`price == 100`
`a != b`	`notEquals(a, b)`	不等于	`category != 'Electronics'`
`a <> b`	`notEquals(a, b)`	不等于 (替代语法)	`category <> 'Electronics'`
`a < b`	`less(a, b)`	小于	`price < 200`
`a <= b`	`lessOrEquals(a, b)`	小于或等于	`price <= 200`
`a > b`	`greater(a, b)`	大于	`price > 500`
`a >= b`	`greaterOrEquals(a, b)`	大于或等于	`price >= 500`
`a LIKE s`	`like(a, b)`	模式匹配 (区分大小写)	`name LIKE '%top%'`
`a NOT LIKE s`	`notLike(a, b)`	模式不匹配 (区分大小写)	`name NOT LIKE '%top%'`
`a ILIKE s`	`ilike(a, b)`	模式匹配 (不区分大小写)	`name ILIKE '%LAPTOP%'`
`a SIMILAR TO s`	`similarTo(a, b)`	SQL 标准模式匹配 (区分大小写)	`name SIMILAR TO 'Lap(top)?'`
`a NOT SIMILAR TO s`	`notSimilarTo(a, b)`	SQL 标准模式不匹配 (区分大小写)	`name NOT SIMILAR TO 'Lap(top)?'`
`a BETWEEN b AND c`	`a >= b AND a <= c`	范围检查 (包含边界)	`price BETWEEN 100 AND 500`
`a NOT BETWEEN b AND c`	`a < b OR a > c`	范围外检查	`price NOT BETWEEN 100 AND 500`

模式匹配和条件表达式

除了比较运算符外，你还可以在 WHERE 子句中使用模式匹配和条件表达式。

Feature	语法	区分大小写	Performance	Best For
`LIKE`	`col LIKE '%pattern%'`	Yes	Fast	区分大小写的精确模式匹配
`ILIKE`	`col ILIKE '%pattern%'`	No	Slower	不区分大小写的搜索
`SIMILAR TO`	`col SIMILAR TO 'p[ab]+%'`	Yes	Slower	支持正则表达式元字符的 SQL 标准模式匹配
`if()`	`if(cond, a, b)`	N/A	Fast	简单条件判断
`multiIf()`	`multiIf(c1, r1, c2, r2, def)`	N/A	Fast	多条件判断
`CASE`	`CASE WHEN ... THEN ... END`	N/A	Fast	符合 SQL 标准的条件逻辑

用法示例请参见“模式匹配和条件表达式”。

包含字面量、列或子查询的表达式

WHERE 子句后面的表达式也可以包含字面量、列或子查询。子查询是嵌套的 SELECT 语句，会返回在条件中使用的值。

类型	定义	求值时机	性能	示例
Literal	固定常量值	编写查询时	最快	`WHERE price > 100`
Column	表数据引用	按行求值	快	`WHERE price > cost`
Subquery	嵌套的 SELECT	查询执行时	视情况而定	`WHERE id IN (SELECT ...)`

你可以在复杂条件中混合使用字面量、列和子查询：

-- Literal + Column
WHERE price > 100 AND category = 'Electronics'

-- Column + Subquery
WHERE price > (SELECT AVG(price) FROM products) AND in_stock = true

-- Literal + Column + Subquery
WHERE category = 'Electronics'
  AND price < 500
  AND id IN (SELECT product_id FROM bestsellers)

-- All three with logical operators
WHERE (price > 100 OR category IN (SELECT category FROM featured))
  AND in_stock = true
  AND name LIKE '%Special%'

示例

判断 `NULL`

带有 NULL 值的查询：

CREATE TABLE t_null(x Int8, y Nullable(Int8)) ENGINE=MergeTree() ORDER BY x;
INSERT INTO t_null VALUES (1, NULL), (2, 3);

SELECT * FROM t_null WHERE y IS NULL;
SELECT * FROM t_null WHERE y != 0;

┌─x─┬────y─┐
│ 1 │ ᴺᵁᴸᴸ │
└───┴──────┘
┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘

使用逻辑运算符过滤数据

给定如下表和数据：

CREATE TABLE products (
    id UInt32,
    name String,
    price Float32,
    category String,
    in_stock Bool
) ENGINE = MergeTree()
ORDER BY id;

INSERT INTO products VALUES
(1, 'Laptop', 999.99, 'Electronics', true),
(2, 'Mouse', 25.50, 'Electronics', true),
(3, 'Desk', 299.00, 'Furniture', false),
(4, 'Chair', 150.00, 'Furniture', true),
(5, 'Monitor', 350.00, 'Electronics', true),
(6, 'Lamp', 45.00, 'Furniture', false);

1. AND - 两个条件都必须成立：

SELECT * FROM products
WHERE category = 'Electronics' AND price < 500;

   ┌─id─┬─name────┬─price─┬─category────┬─in_stock─┐
1. │  2 │ Mouse   │  25.5 │ Electronics │ true     │
2. │  5 │ Monitor │   350 │ Electronics │ true     │
   └────┴─────────┴───────┴─────────────┴──────────┘

2. OR - 至少有一个条件必须成立：

SELECT * FROM products
WHERE category = 'Furniture' OR price > 500;

   ┌─id─┬─name───┬──price─┬─category────┬─in_stock─┐
1. │  1 │ Laptop │ 999.99 │ Electronics │ true     │
2. │  3 │ Desk   │    299 │ Furniture   │ false    │
3. │  4 │ Chair  │    150 │ Furniture   │ true     │
4. │  6 │ Lamp   │     45 │ Furniture   │ false    │
   └────┴────────┴────────┴─────────────┴──────────┘

3. NOT - 对条件取反：

SELECT * FROM products
WHERE NOT in_stock;

   ┌─id─┬─name─┬─price─┬─category──┬─in_stock─┐
1. │  3 │ Desk │   299 │ Furniture │ false    │
2. │  6 │ Lamp │    45 │ Furniture │ false    │
   └────┴──────┴───────┴───────────┴──────────┘

4. XOR - 必须恰好只有一个条件为真 (不能同时都为真) ：

SELECT *
FROM products
WHERE xor(price > 200, category = 'Electronics')

   ┌─id─┬─name──┬─price─┬─category────┬─in_stock─┐
1. │  2 │ Mouse │  25.5 │ Electronics │ true     │
2. │  3 │ Desk  │   299 │ Furniture   │ false    │
   └────┴───────┴───────┴─────────────┴──────────┘

5. 结合多个运算符：

SELECT * FROM products
WHERE (category = 'Electronics' OR category = 'Furniture')
  AND in_stock = true
  AND price < 400;

   ┌─id─┬─name────┬─price─┬─category────┬─in_stock─┐
1. │  2 │ Mouse   │  25.5 │ Electronics │ true     │
2. │  4 │ Chair   │   150 │ Furniture   │ true     │
3. │  5 │ Monitor │   350 │ Electronics │ true     │
   └────┴─────────┴───────┴─────────────┴──────────┘

6. 使用函数语法：

SELECT * FROM products
WHERE and(or(category = 'Electronics', price > 100), in_stock);

   ┌─id─┬─name────┬──price─┬─category────┬─in_stock─┐
1. │  1 │ Laptop  │ 999.99 │ Electronics │ true     │
2. │  2 │ Mouse   │   25.5 │ Electronics │ true     │
3. │  4 │ Chair   │    150 │ Furniture   │ true     │
4. │  5 │ Monitor │    350 │ Electronics │ true     │
   └────┴─────────┴────────┴─────────────┴──────────┘

SQL 关键字语法 (AND、OR、NOT、XOR) 通常更易于阅读，但在复杂表达式中或构建动态查询时，函数语法也很有用。

将 UInt8 列用作条件

沿用前一个示例中的表，你可以直接将列名作为条件使用：

SELECT * FROM products
WHERE in_stock

   ┌─id─┬─name────┬──price─┬─category────┬─in_stock─┐
1. │  1 │ Laptop  │ 999.99 │ Electronics │ true     │
2. │  2 │ Mouse   │   25.5 │ Electronics │ true     │
3. │  4 │ Chair   │    150 │ Furniture   │ true     │
4. │  5 │ Monitor │    350 │ Electronics │ true     │
   └────┴─────────┴────────┴─────────────┴──────────┘

使用比较运算符

以下示例使用上方示例中的表和数据。为简洁起见，结果已省略。 1. 显式等于 true (= 1 或 = true) ：

SELECT * FROM products
WHERE in_stock = true;
-- 或
WHERE in_stock = 1;

2. 显式地与 false 相等 (= 0 或 = false) ：

SELECT * FROM products
WHERE in_stock = false;
-- 或
WHERE in_stock = 0;

3. 不等于 (!= 0 或 != false) ：

SELECT * FROM products
WHERE in_stock != false;
-- 或
WHERE in_stock != 0;

4. 大于：

SELECT * FROM products
WHERE in_stock > 0;

5. 小于等于：

SELECT * FROM products
WHERE in_stock <= 0;

6. 与其他条件结合使用：

SELECT * FROM products
WHERE in_stock AND price < 400;

7. 使用 IN 运算符： 在下面的示例中，(1, true) 是一个元组。

SELECT * FROM products
WHERE in_stock IN (1, true);

你也可以使用数组来实现这一点：

SELECT * FROM products
WHERE in_stock IN [1, true];

8. 混用比较写法：

SELECT * FROM products
WHERE category = 'Electronics' AND in_stock = true;

模式匹配和条件表达式

下面的示例使用了上面示例中的表和数据。为简洁起见，结果已省略。

LIKE 示例

-- 查找名称中包含 'o' 的产品
SELECT * FROM products WHERE name LIKE '%o%';
-- 结果：Laptop, Monitor

-- 查找名称以 'L' 开头的产品
SELECT * FROM products WHERE name LIKE 'L%';
-- 结果：Laptop, Lamp

-- 查找名称恰好为 4 个字符的产品
SELECT * FROM products WHERE name LIKE '____';
-- 结果：Desk, Lamp

ILIKE 示例

-- 不区分大小写搜索 'LAPTOP'
SELECT * FROM products WHERE name ILIKE '%laptop%';
-- 结果：Laptop

-- 不区分大小写的前缀匹配
SELECT * FROM products WHERE name ILIKE 'l%';
-- 结果：Laptop, Lamp

SIMILAR TO 示例

与 LIKE 不同，SIMILAR TO 模式还支持正则表达式元字符 |、*、+、?、{、}、(、)、[ 和 ]；但与 LIKE 相同的是，它必须匹配整个值：

-- Alternation: either of two names
SELECT * FROM products WHERE name SIMILAR TO 'Desk|Lamp';
-- Result: Desk, Lamp

-- A bracket expression combined with the LIKE wildcard `%`
SELECT * FROM products WHERE name SIMILAR TO '[LM]%';
-- Result: Laptop, Mouse, Monitor, Lamp

-- Repetition: a name of five or more characters
SELECT * FROM products WHERE name SIMILAR TO '_{5,}';
-- Result: Laptop, Mouse, Chair, Monitor

-- Negation
SELECT * FROM products WHERE name NOT SIMILAR TO '(Desk|Lamp)';
-- Result: Laptop, Mouse, Chair, Monitor

可以通过 ESCAPE 子句指定自定义转义字符，该子句同样适用于 LIKE、ILIKE、NOT LIKE、NOT ILIKE 和 NOT SIMILAR TO：

-- `#%` denotes a literal `%`, so this matches names containing a percent sign
SELECT * FROM products WHERE name SIMILAR TO '%#%%' ESCAPE '#';
-- Result: (none)

完整的模式语法请参阅 SIMILAR TO 运算符文档。

IF 示例

-- 按类别设置不同的价格阈值
SELECT * FROM products
WHERE if(category = 'Electronics', price < 500, price < 200);
-- 结果：Mouse、Chair、Monitor
-- （Electronics 低于 $500 或 Furniture 低于 $200）

-- 根据库存状态过滤
SELECT * FROM products
WHERE if(in_stock, price > 100, true);
-- 结果：Laptop、Chair、Monitor、Desk、Lamp
-- （有库存且价格超过 $100 的商品，或所有缺货商品）

multiIf 示例

-- 基于多个类别的条件
SELECT * FROM products
WHERE multiIf(
    category = 'Electronics', price < 600,
    category = 'Furniture', in_stock = true,
    false
);
-- 结果：Mouse, Monitor, Chair
-- （Electronics 价格 < $600 或有库存的 Furniture）

-- 分层过滤
SELECT * FROM products
WHERE multiIf(
    price > 500, category = 'Electronics',
    price > 100, in_stock = true,
    true
);
-- 结果：Laptop, Chair, Monitor, Lamp

CASE 示例

简单的 CASE：

-- Different rules per category
SELECT * FROM products
WHERE CASE category
    WHEN 'Electronics' THEN price < 400
    WHEN 'Furniture' THEN in_stock = true
    ELSE false
END;
-- Result: Mouse, Monitor, Chair

搜索型 CASE：

-- Price-based tiered logic
SELECT * FROM products
WHERE CASE
    WHEN price > 500 THEN in_stock = true
    WHEN price > 100 THEN category = 'Electronics'
    ELSE true
END;
-- Result: Laptop, Monitor, Mouse, Lamp

SQL 参考文档

数据类型

引擎

函数

格式

设置

系统表

数据湖

判断 `NULL`

使用逻辑运算符过滤数据

将 UInt8 列用作条件

使用比较运算符

模式匹配和条件表达式

包含字面量、列或子查询的表达式

示例

判断 `NULL`

使用逻辑运算符过滤数据

将 UInt8 列用作条件

使用比较运算符

模式匹配和条件表达式

LIKE 示例

ILIKE 示例

SIMILAR TO 示例

IF 示例

multiIf 示例

CASE 示例

​判断 NULL

​使用逻辑运算符过滤数据

​将 UInt8 列用作条件

​使用比较运算符

​模式匹配和条件表达式

​包含字面量、列或子查询的表达式

​示例

​判断 NULL

​使用逻辑运算符过滤数据

​将 UInt8 列用作条件

​使用比较运算符

​模式匹配和条件表达式

​LIKE 示例

​ILIKE 示例

​SIMILAR TO 示例

​IF 示例

​multiIf 示例

​CASE 示例

判断 `NULL`

使用逻辑运算符过滤数据

将 UInt8 列用作条件

使用比较运算符

模式匹配和条件表达式

包含字面量、列或子查询的表达式

示例

判断 `NULL`

使用逻辑运算符过滤数据

将 UInt8 列用作条件

使用比较运算符

模式匹配和条件表达式

LIKE 示例

ILIKE 示例

SIMILAR TO 示例

IF 示例

multiIf 示例

CASE 示例