메인 콘텐츠로 건너뛰기
TRUNCATE를 사용하면 테이블이나 데이터베이스는 그대로 유지한 채 그 안의 데이터를 제거할 수 있습니다. 이 작업은 가볍지만 되돌릴 수 없습니다. ClickHouse의 TRUNCATE 문은 테이블 또는 데이터베이스의 구조는 유지하면서 모든 데이터를 빠르게 제거하는 데 사용됩니다.

TRUNCATE TABLE

TRUNCATE TABLE [IF EXISTS] [db.]name [ON CLUSTER cluster] [SYNC]

매개변수설명
IF EXISTS테이블이 존재하지 않아도 오류가 발생하지 않도록 합니다. 생략하면 쿼리가 오류를 반환합니다.
db.name선택 사항인 데이터베이스 이름입니다.
ON CLUSTER cluster지정된 클러스터 전체에서 명령을 실행합니다.
SYNC복제된 테이블을 사용할 때 TRUNCATE를 레플리카 전체에 동기식으로 적용합니다. 생략하면 기본적으로 비동기식으로 수행됩니다.
alter_sync 설정을 사용하여 레플리카에서 작업이 실행될 때까지 대기하도록 설정할 수 있습니다. replication_wait_for_inactive_replica_timeout 설정을 사용하여 비활성 레플리카가 TRUNCATE 쿼리를 실행할 때까지 얼마나 오래 기다릴지(초 단위) 지정할 수 있습니다.
alter_sync2로 설정되어 있고 일부 레플리카가 replication_wait_for_inactive_replica_timeout 설정에 지정된 시간보다 오래 비활성 상태로 남아 있으면 UNFINISHED 예외가 발생합니다.
TRUNCATE TABLE 쿼리는 다음 테이블 엔진에서는 지원되지 않습니다:

모든 테이블 TRUNCATE하기

TRUNCATE [ALL] TABLES FROM [IF EXISTS] db [LIKE | ILIKE | NOT LIKE '<pattern>'] [ON CLUSTER cluster]

매개변수설명
ALL데이터베이스의 모든 테이블에서 데이터를 제거합니다.
IF EXISTS데이터베이스가 존재하지 않을 때 오류가 발생하지 않도록 합니다.
db데이터베이스 이름입니다.
LIKE | ILIKE | NOT LIKE '<pattern>'패턴으로 테이블을 필터링합니다.
ON CLUSTER cluster클러스터 전체에서 명령을 실행합니다.
데이터베이스의 모든 테이블에서 모든 데이터를 제거합니다.

TRUNCATE DATABASE

TRUNCATE DATABASE [IF EXISTS] db [ON CLUSTER cluster]

매개변수설명
IF EXISTS데이터베이스가 존재하지 않아도 오류가 발생하지 않도록 합니다.
db데이터베이스 이름입니다.
ON CLUSTER cluster지정된 클러스터 전체에서 명령을 실행합니다.
데이터베이스 자체는 유지하면서 데이터베이스의 모든 테이블을 삭제합니다. IF EXISTS 절을 생략하면 데이터베이스가 존재하지 않을 경우 쿼리가 오류를 반환합니다.
TRUNCATE DATABASEReplicated 데이터베이스에서 지원되지 않습니다. 대신 데이터베이스를 DROP한 후 다시 CREATE하십시오.
마지막 수정일 2026년 6월 10일