Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

WHERE

View as MarkdownEdit this pageReport an issueSet up docs MCP

WHERE 子句允许你过滤 SELECT 的 FROM 子句返回的数据。

如果存在 WHERE 子句，其后必须跟一个 UInt8 类型的表达式。 表达式求值结果为 0 的行会被排除，不再参与后续转换或最终结果。

WHERE 子句后的表达式通常会结合比较运算符和逻辑运算符使用，或者使用众多常规函数中的一种。

如果底层表引擎支持，系统在计算 WHERE 表达式时会利用索引和分区裁剪能力。

判断 NULL

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

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

使用逻辑运算符过滤数据

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

将 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 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 Syntax Case-Sensitive Performance Best For
LIKE col LIKE '%pattern%' Yes Fast 区分大小写的精确模式匹配
ILIKE col ILIKE '%pattern%' No Slower 不区分大小写的搜索
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

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
Navigation