메인 콘텐츠로 건너뛰기
기존 엔터티를 삭제합니다. IF EXISTS 절을 지정하면 엔터티가 존재하지 않더라도 이 쿼리는 오류를 반환하지 않습니다. SYNC 수정자를 지정하면 엔터티가 즉시 삭제됩니다.

DROP DATABASE

db 데이터베이스 내의 모든 테이블을 삭제한 후, db 데이터베이스 자체도 삭제합니다. 구문:
DROP DATABASE [IF EXISTS] db [ON CLUSTER cluster] [SYNC]

DROP TABLE

하나 이상의 테이블을 삭제합니다.
테이블 삭제를 취소하려면 UNDROP TABLE을 참조하십시오.
구문:
DROP [TEMPORARY] TABLE [IF EXISTS] [IF EMPTY]  [db1.]name_1[, [db2.]name_2, ...] [ON CLUSTER cluster] [SYNC]
제한 사항:
  • IF EMPTY 절이 지정되면, server는 쿼리를 받은 레플리카에서만 테이블이 비어 있는지 확인합니다.
  • 여러 테이블을 한 번에 삭제하는 작업은 원자적 작업이 아닙니다. 즉, 하나의 테이블 삭제에 실패하면 이후 테이블은 삭제되지 않습니다.

DROP DICTIONARY

딕셔너리를 삭제합니다. 구문:
DROP DICTIONARY [IF EXISTS] [db.]name [SYNC]

DROP USER

사용자를 삭제합니다. 구문:
DROP USER [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP ROLE

역할을 삭제합니다. 삭제된 역할은 할당되어 있던 모든 엔터티에서 해제됩니다. 구문:
DROP ROLE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

ROW POLICY 삭제

ROW POLICY를 삭제합니다. 삭제된 ROW POLICY는 할당된 모든 엔터티에서 해제됩니다. 구문:
DROP [ROW] POLICY [IF EXISTS] name [,...] ON [database.]table [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP MASKING POLICY

마스킹 정책을 삭제합니다. 구문:
DROP MASKING POLICY [IF EXISTS] name ON [database.]table [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP QUOTA

QUOTA를 삭제합니다. 삭제된 QUOTA는 할당된 모든 엔터티에서 해제됩니다. 구문:
DROP QUOTA [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP SETTINGS PROFILE

설정 프로필을 삭제합니다. 삭제된 설정 프로필은 할당된 모든 엔터티에서 해제됩니다. 구문:
DROP [SETTINGS] PROFILE [IF EXISTS] name [,...] [ON CLUSTER cluster_name] [FROM access_storage_type]

DROP VIEW

뷰를 삭제합니다. 뷰는 DROP TABLE 명령으로도 삭제할 수 있지만, DROP VIEW[db.]name이 뷰인지 확인한 후 삭제합니다. 구문:
DROP VIEW [IF EXISTS] [db.]name [ON CLUSTER cluster] [SYNC]

DROP FUNCTION

CREATE FUNCTION으로 생성된 사용자 정의 함수를 삭제합니다. 시스템 함수는 삭제할 수 없습니다. 구문
DROP FUNCTION [IF EXISTS] function_name [on CLUSTER cluster]
예시
CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
DROP FUNCTION linear_equation;

DROP NAMED COLLECTION

명명된 컬렉션을 삭제합니다. 구문
DROP NAMED COLLECTION [IF EXISTS] name [on CLUSTER cluster]
예시
CREATE NAMED COLLECTION foobar AS a = '1', b = '2';
DROP NAMED COLLECTION foobar;
마지막 수정일 2026년 6월 10일