WHERE

WHERE 절을 사용하면 SELECT의 FROM 절에서 가져오는 데이터를 필터링할 수 있습니다. WHERE 절이 있으면 그 뒤에는 UInt8 유형의 표현식이 와야 합니다. 이 표현식의 평가 결과가 0인 행은 이후 처리나 결과에서 제외됩니다. WHERE 절 뒤의 표현식은 비교 및 논리 연산자, 또는 여러 일반 함수와 함께 자주 사용됩니다. 기반 테이블 엔진이 이를 지원하면 WHERE 표현식은 인덱스와 파티션 프루닝을 활용할 수 있도록 평가됩니다.

PREWHEREPREWHERE라는 필터링 최적화도 있습니다. 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이고, 0이 아닌 모든 값(일반적으로 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 절에서 패턴 매칭과 조건 표현식을 사용할 수 있습니다.

기능	구문	대소문자 구분	성능	적합한 용도
`LIKE`	`col LIKE '%pattern%'`	예	빠름	대소문자를 구분하는 정확한 패턴 매칭
`ILIKE`	`col ILIKE '%pattern%'`	아니요	더 느림	대소문자를 구분하지 않는 검색
`SIMILAR TO`	`col SIMILAR TO 'p[ab]+%'`	예	더 느림	정규식 메타문자를 사용하는 SQL 표준 패턴
`if()`	`if(cond, a, b)`	해당 없음	빠름	단순한 이진 조건
`multiIf()`	`multiIf(c1, r1, c2, r2, def)`	해당 없음	빠름	여러 조건
`CASE`	`CASE WHEN ... THEN ... END`	해당 없음	빠름	SQL 표준 조건 처리

사용 예시는 “패턴 매칭과 조건 표현식”을 참조하십시오.

리터럴, 컬럼 또는 서브쿼리가 있는 표현식

WHERE 절 뒤에 오는 표현식에는 리터럴, 컬럼 또는 서브쿼리도 포함될 수 있습니다. 서브쿼리는 조건에 사용할 값을 반환하는 중첩된 SELECT SQL 문입니다.

유형	정의	평가	성능	예시
리터럴	고정된 상수 값	쿼리 작성 시점	가장 빠름	`WHERE price > 100`
컬럼	테이블 데이터 참조	각 행마다	빠름	`WHERE price > cost`
서브쿼리	중첩된 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)는 tuple입니다.

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 예시

SIMILAR TO 패턴은 LIKE와 달리 정규식 메타문자 |, *, +, ?, {, }, (, ), [, ]도 사용할 수 있으며, 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 미만 OR Furniture 중 $200 미만)

-- 재고 상태에 따른 필터
SELECT * FROM products
WHERE if(in_stock, price > 100, true);
-- 결과: Laptop, Chair, Monitor, Desk, Lamp
-- ($100 초과 재고 보유 항목 OR 재고 없는 모든 항목)

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 예시