DROP TABLE

적용 대상:check marked yes Databricks SQL check marked yes Databricks 런타임

테이블을 삭제하고 테이블이 EXTERNAL 테이블이 아닌 경우 파일 시스템에서 테이블과 연결된 디렉터리를 제거합니다. 테이블이 없으면 예외가 throw됩니다. 테이블을 삭제하려면 해당 테이블의 소유자이거나 테이블이 있는 스키마, 카탈로그 또는 메타스토어의 소유자여야 합니다.

외부 테이블의 경우 메타스토어 스키마에서 연결된 메타데이터 정보만 제거됩니다.

테이블을 참조하는 모든 외래 키 제약 조건도 삭제됩니다.

테이블이 캐시되면 명령은 테이블 및 모든 종속성을 캐시하지 않습니다.

참고 항목

관리되는 테이블이 Unity 카탈로그에서 삭제되면 30일 이내에 기본 데이터가 클라우드 테넌트에서 삭제됩니다.

구문

DROP TABLE [ IF EXISTS ] table_name

매개 변수

  • IF EXISTS

    지정된 경우 테이블이 존재하지 않을 때 TABLE_OR_VIEW_NOT_FOUND 오류가 발생하지 않습니다.

  • table_name

    삭제할 테이블의 이름입니다. 이름에는 임시 사양이 포함되지 않아야 합니다. 테이블을 찾을 수 없는 경우 Azure Databricks는 TABLE_OR_VIEW_NOT_FOUND 오류를 발생시킵니다.

예제

-- Assumes a table named `employeetable` exists.
> DROP TABLE employeetable;

-- Assumes a table named `employeetable` exists in the `userdb` schema
> DROP TABLE userdb.employeetable;

-- Assumes a table named `employeetable` does not exist.
-- Throws TABLE_OR_VIEW_NOT_FOUND
> DROP TABLE employeetable;
  Error: TABLE_OR_VIEW_NOT_FOUND

-- Assumes a table named `employeetable` does not exist,Try with IF EXISTS
-- this time it will not throw exception
> DROP TABLE IF EXISTS employeetable;