용어집

-State, -Merge집계의 중간 상태를 저장(-State)하고 나중에 합치는(-Merge) 컴비네이터. AggregatingMergeTree 와 짝

AggregatingMergeTree집계 상태(-State)를 머지 때 합치는 엔진. uniq, quantile 같은 비가산 집계의 증분 롤업에 사용

argMax, argMin다른 컬럼이 최대(최소)인 행의 값을 가져오는 집계. 최신 상태 조회에서 FINAL 대신 자주 사용

arrayJoin배열 원소마다 행을 복제해 펼치는 함수. ARRAY JOIN 절과 같은 효과

BACKUP, RESTORE테이블이나 데이터베이스를 S3, 디스크로 백업하고 복원하는 문. 증분 백업과 ASYNC 지원

BYOCBring Your Own Cloud. 고객 계정 안에 ClickHouse Cloud 를 배포하고 ClickHouse 가 운영하는 방식

chDB프로세스 안에 심어 쓰는 ClickHouse 엔진(Python 등). 서버 없이 파일과 DataFrame 을 쿼리. WASM 빌드도 있음

ClickHouse KeeperZooKeeper 호환 코디네이션 서비스. 복제 로그, 리더 선출, DDL 큐를 관리. ZooKeeper 대신 권장

clickhouse-client공식 CLI. 네이티브 TCP(9000)로 접속. clickhouse-local 은 서버 없이 파일을 쿼리

ClickPipesClickHouse Cloud 의 관리형 수집 서비스. Kafka, Kinesis, S3, GCS, Postgres CDC, MySQL CDC 등

ClickStackClickHouse, OpenTelemetry 컬렉터, HyperDX UI 로 이뤄진 오픈 소스 관측성 스택

CollapsingMergeTreesign 컬럼(1, -1) 쌍을 머지 때 상쇄시켜 지우는 엔진. VersionedCollapsing 은 순서 무관 버전까지 다룸

CREATE TOKEN26.9 의 기한 있는 자격 증명. 사용자 권한의 일부만 담아 발급

DateTime64소수점 이하(밀리초, 마이크로초) 정밀도를 가진 날짜 시간 타입. DateTime 은 초 단위

Decimal고정 소수점 타입. 금액처럼 오차가 없어야 하는 값에 Float 대신 사용

Distributed 엔진클러스터의 여러 샤드에 쿼리를 보내고 결과를 모으는 가상 테이블. 데이터를 직접 저장하지 않음

EXPLAIN쿼리 계획(PLAN), 파이프라인, 인덱스 사용(indexes = 1)을 보여 주는 문. 왜 느린지 볼 때 첫 단계

FINAL조회 시점에 머지가 끝난 것처럼 중복을 정리해서 읽는 수정자. 정확하지만 비용이 커서 작은 범위에만

HTTP 인터페이스8123 포트의 REST 접속. 드라이버 다수(clickhouse-connect, clickhouse-js)가 이 위에서 동작

HyperDX로그, 트레이스, 메트릭, 세션 리플레이를 보는 UI. 2025 년 ClickHouse 가 인수해 ClickStack 의 얼굴이 됨

Iceberg, Delta Lake, Hudi오픈 테이블 포맷. 테이블 함수와 엔진으로 읽고, 카탈로그(REST, Glue, Unity) 데이터베이스 엔진으로 붙임

JOIN 알고리즘hash, parallel_hash(기본), grace_hash(디스크 스필), full_sorting_merge, partial_merge, direct(딕셔너리). join_algorithm 설정

JSON 타입25.3 에서 GA 된 네이티브 반정형 타입. 경로마다 서브컬럼으로 저장해 열 지향 압축과 조회 속도를 유지

Kafka 엔진Kafka 토픽을 테이블처럼 읽는 엔진. 보통 MV 로 MergeTree 테이블에 옮겨 담아 사용

LIMIT BY그룹마다 n 행씩 자르는 ClickHouse 고유 절. 그룹별 상위 n 조회

LowCardinality값 종류가 적은(보통 1만 미만) 문자열을 사전 인코딩하는 타입 래퍼. 저장과 GROUP BY 가 빨라짐

LTSLong Term Support 릴리스. 3월과 8월 릴리스가 LTS 로 1년 동안 버그 수정. 운영은 LTS 권장

max_memory_usage쿼리 하나가 쓸 수 있는 메모리 상한. 넘으면 Memory limit (for query) exceeded

MergeTreeClickHouse 의 기본 테이블 엔진 가족. INSERT 마다 정렬된 파트를 만들고 백그라운드에서 합치는(머지) 구조

Native 포맷ClickHouse 사이의 가장 효율적인 열 지향 바이너리 포맷. clickhouse-client 와 서버 사이 기본

NullableNULL 을 허용하는 타입 래퍼. 별도 마스크 파일이 생겨 조금 느려지니 기본값(0, 빈 문자열)으로 대신할 수 있으면 피함

OpenTelemetry (OTel)관측 데이터 수집 표준. ClickStack 은 OTel 컬렉터의 ClickHouse 익스포터로 적재

PeerDBClickHouse 가 인수한 Postgres CDC 도구. ClickPipes 의 Postgres 커넥터 바탕

Pipelined SQL (|>)26.x 에 들어온 파이프 연산자 문법. FROM 부터 시작해 단계를 이어 쓰는 쿼리

PREWHEREWHERE 전에 적은 컬럼만 먼저 읽어 거르는 최적화 단계. 보통 자동으로 옮겨지지만 직접 쓸 수도 있음

ProfileEvents쿼리마다 쌓이는 상세 카운터(읽은 마크, 캐시 적중, 스필 등). query_log 의 ProfileEvents 컬럼

quantile분위수 추정 함수. quantileTDigest, quantileExact 등 정확도와 메모리에 따라 변형 선택

Refreshable MV일정 주기로 쿼리를 통째로 다시 실행해 결과를 바꿔 끼우는 뷰. 26.x 부터 연쇄(DEPENDS ON)와 증분(APPEND INCREMENTAL) 지원

ReplacingMergeTree같은 정렬 키 행 중 마지막(또는 ver 컬럼이 큰) 행만 남기는 엔진. 머지 전에는 중복이 보일 수 있어 FINAL 이나 argMax 가 필요

ReplicatedMergeTreeKeeper 를 통해 여러 서버가 같은 파트를 갖도록 복제하는 엔진. Cloud 의 SharedMergeTree 와 구분

s3 테이블 함수S3 의 파일을 바로 읽거나 쓰는 함수. 와일드카드, 스키마 추론, 파티션 쓰기 지원. 엔진 S3 와 S3Queue 도 있음

S3Queue버킷에 새로 들어온 파일을 자동으로 읽어 들이는 엔진. 보통 MV 와 함께 스트리밍 적재에 사용

SharedMergeTreeClickHouse Cloud 전용 엔진. 데이터는 오브젝트 스토리지에 한 벌, 컴퓨트 노드는 메타데이터만 공유

SummingMergeTree같은 정렬 키 행의 숫자 컬럼을 머지 때 더하는 엔진. 집계 롤업 테이블에 사용

system.metrics, system.events현재 값(metrics)과 누적 카운터(events). asynchronous_metrics 는 주기적으로 계산되는 값

system.parts, system.merges파트 상태와 진행 중인 머지를 보는 시스템 테이블. Too many parts 진단의 기본

system.query_log실행된 쿼리의 시간, 읽은 행과 바이트, 메모리, 예외를 기록하는 시스템 테이블. 성능 분석의 출발점

TimeSeries 엔진, PromQLPrometheus 데이터를 저장하고 PromQL 로 묻는 기능. Cloud 에서는 Private Preview

Too many parts활성 파트 수가 parts_to_throw_insert 를 넘어 INSERT 가 거부되는 상태. 원인은 대개 잦은 소량 INSERT

TTL행이나 컬럼의 수명. 기한이 지나면 삭제, 다른 디스크(볼륨)로 이동, 집계 롤업을 머지 때 수행

uniq, uniqExact고유 개수 추정 함수(uniq, uniqCombined, uniqHLL12)와 정확 계산(uniqExact). 추정이 훨씬 가볍다

Variant, Dynamic여러 타입 중 하나를 담는 Variant, 타입을 미리 정하지 않는 Dynamic. JSON 타입의 바탕

WITH FILLORDER BY 뒤에 붙여 빠진 시간 구간을 채워 주는 절. 시계열 그래프의 빈 칸 채우기

경량 갱신 (lightweight UPDATE)UPDATE 문으로 패치 파트를 써서 바로 반영하는 갱신. 전체 파트를 다시 쓰는 뮤테이션보다 가벼움

경량 삭제 (lightweight DELETE)DELETE FROM 문. 삭제 마스크만 기록하고 실제 정리는 머지에서. 바로 안 보이게 되지만 공간은 나중에 회수

그래뉼 (granule)읽기의 최소 단위. 기본 8,192 행(index_granularity). 기본 키 인덱스는 그래뉼마다 한 마크를 가짐

기본 키 (PRIMARY KEY)희소 인덱스에 들어가는 컬럼. 생략하면 정렬 키와 같고, 정렬 키의 접두사여야 함

네임드 컬렉션 (named collection)S3, Kafka, Postgres 접속 정보를 이름으로 저장해 두고 재사용하는 객체. 쿼리에 비밀을 안 적게 함

딕셔너리 (dictionary)외부 소스(테이블, 파일, HTTP)를 메모리에 올려 dictGet 으로 키 조회하는 구조. 작은 차원 테이블 JOIN 대체

람다 (lambda)x -> x * 2 꼴로 arrayMap, arrayFilter 같은 고차 배열 함수에 넘기는 식

마크 (mark)그래뉼의 시작 위치를 가리키는 인덱스 항목. 희소 기본 키 인덱스가 메모리에 들고 있는 것

머지 (merge)작은 파트 여러 개를 하나로 합치는 백그라운드 작업. 이때 Replacing, Summing 같은 엔진의 규칙이 적용됨

머티리얼라이즈드 뷰 (MV)원본 테이블에 INSERT 되는 블록마다 쿼리를 실행해 대상 테이블에 쓰는 INSERT 트리거. 과거 데이터는 보지 않음

멱등 INSERT같은 블록을 다시 넣어도 중복되지 않는 성질. 복제 테이블은 블록 해시로 최근 INSERT 중복을 걸러 냄

뮤테이션 (mutation)ALTER TABLE ... UPDATE/DELETE 로 파트를 다시 쓰는 무거운 작업. system.mutations 에서 진행 확인

벡터 유사도 인덱스Array(Float32) 컬럼에 거는 근사 최근접(ANN) 인덱스. 임베딩 검색용

병렬 복제본 (parallel replicas)한 쿼리를 같은 샤드의 여러 복제본이 나눠 읽는 기능. 샤딩 없이 읽기 성능을 늘림

복제 큐 (replication queue)복제본이 아직 처리하지 못한 작업(파트 받기, 머지, 뮤테이션) 목록. system.replication_queue

비동기 INSERT (async_insert)서버가 작은 INSERT 를 모아 한 파트로 쓰는 설정. 클라이언트에서 배치하기 어려울 때

새 분석기 (analyzer)24.3 부터 기본인 쿼리 분석 엔진. 표준 SQL 호환성과 최적화가 좋아졌고 일부 옛 동작이 바뀜

샘플링 키 (SAMPLE BY)SAMPLE 절로 일부만 읽을 때 쓰는 키. 기본 키 안에 들어 있어야 함

샤드 (shard)데이터를 서버 묶음별로 나눈 조각. Distributed 테이블이 샤드에 쿼리를 뿌리고 결과를 합침

설정 프로필 (settings profile)사용자별로 묶어 적용하는 설정 집합. 메모리 한도, 읽기 한도, 읽기 전용 등

스키마 추론 (schema inference)파일을 읽을 때 컬럼 타입을 자동으로 알아내는 기능. s3, file, url 함수에서 바로 SELECT 가능

스킵 인덱스 (data skipping index)그래뉼 묶음을 건너뛰게 돕는 보조 인덱스. minmax, set, bloom_filter, ngrambf_v1, tokenbf_v1 등

스토리지 정책 (storage policy)디스크와 볼륨을 묶은 설정. 핫 데이터는 SSD, 콜드 데이터는 S3 처럼 티어링

스필 (spill)GROUP BY, 정렬, JOIN 의 중간 결과를 디스크로 내리는 것. max_bytes_before_external_group_by 등으로 켬

실행 가능 UDF외부 프로그램을 함수처럼 부르는 사용자 정의 함수. Cloud 에서는 2026-10 에 GA, Rust, Go, C++, JS 런타임

웨어하우스 (warehouse)Cloud 에서 같은 데이터를 여러 컴퓨트 서비스가 따로 쓰는 compute-compute 분리 단위

전문 인덱스 (text index)토크나이저로 단어를 색인해 hasToken, LIKE 를 빠르게 하는 인덱스. 로그 검색용

정렬 키 (ORDER BY)파트 안에서 행이 정렬되는 기준. 압축률과 조회 범위를 모두 결정하는 가장 중요한 설계 요소

컴비네이터 (combinator)집계 함수에 붙는 접미사. -If(조건), -Array(배열 풀기), -State(중간 상태), -Merge(상태 합침), -ForEach

코덱 (codec)컬럼별 압축 방식. 범용 LZ4, ZSTD 와 특화 Delta, DoubleDelta, Gorilla, T64 를 겹쳐 쓸 수 있음

쿼리 조건 캐시WHERE 조건에 맞지 않는 그래뉼 정보를 기억해 반복 쿼리를 빠르게 하는 캐시. 25.3 에 들어옴

쿼리 캐시 (query cache)같은 SELECT 결과를 잠시 재사용하는 캐시(use_query_cache). 결정적 쿼리에만 안전

쿼터 (quota)사용자별 시간 구간당 쿼리 수, 읽은 행 수 등의 사용량 제한

파트 (part)INSERT 한 번(또는 머지 결과)으로 생기는 디스크 위 불변 데이터 조각. system.parts 에서 확인

파티션 키 (PARTITION BY)파트를 큰 묶음으로 나누는 기준(보통 월). 데이터 관리(DROP PARTITION, TTL)용이며 조회 가속 목적이 아님

포맷 (format)입출력 데이터 형식. JSONEachRow, CSV, Parquet, Native, Arrow, RowBinary 등 70 가지 이상

프로젝션 (projection)같은 데이터를 다른 정렬 키나 집계 형태로 파트 안에 함께 저장하는 것. 쿼리에 맞는 쪽을 자동 선택

행 정책 (row policy)사용자별로 보이는 행을 제한하는 규칙(CREATE ROW POLICY). 행 수준 보안