ALTER TABLE ... PARTITION

적용 대상: Databricks SQL Databricks Runtime

테이블의 파티션을 추가, 삭제, 이름 바꾸기 또는 복구합니다.

Delta Lake 테이블에는 파티션 관리가 지원되지 않습니다.

구문

ALTER TABLE table_name
   { ADD PARTITION clause |
     DROP PARTITION clause |
     PARTITION SET LOCATION clause |
     RENAME PARTITION clause |
     RECOVER PARTITIONS clause }

ADD PARTITION 조항

테이블에 하나 이상의 파티션을 추가합니다.

Delta Lake 테이블에는 파티션 관리가 지원되지 않습니다.

구문

ADD [IF NOT EXISTS] { PARTITION clause [ LOCATION path ] } [...]

매개 변수

• IF NOT EXISTS

  파티션이 이미 있는 경우 문을 무시하도록 Azure Databricks에 지시하는 선택적 절입니다.

• PARTITION 절

  추가할 파티션입니다. 파티션 키는 테이블의 분할과 일치해야 하며 값과 연결되어야 합니다. 파티션이 이미 있으면 IF NOT EXISTS를 지정하지 않은 경우 오류가 발생합니다.

• LOCATION path

  path 는 파티션을 STRING 가리키는 선택적 위치를 나타내는 리터럴이어야 합니다.

  위치가 지정되지 않은 경우 위치는 테이블 및 파티션 키의 위치에서 파생됩니다.

  위치에 파일이 있는 경우 해당 파일은 파티션을 채우며 테이블의 data_source 및 해당 옵션과 호환되어야 합니다.

DROP PARTITION 조항

테이블에서 하나 이상의 파티션을 삭제하고 파티션의 위치에 있는 파일을 선택적으로 삭제합니다.

Delta Lake 테이블에는 파티션 관리가 지원되지 않습니다.

구문

DROP [ IF EXISTS ] PARTITION clause [, ...] [PURGE]

매개 변수

• IF EXISTS

  IF EXISTS를 지정하면 Azure Databricks에서 존재하지 않는 파티션을 삭제하려고 하지 않습니다. 그러지 않으면 파티션이 없는 경우 오류가 발생합니다.

• PARTITION 절

  삭제할 파티션을 지정합니다. 파티션이 부분적으로만 식별되면 파티션 조각이 삭제됩니다.

• PURGE

  설정된 경우 테이블 카탈로그는 휴지통 폴더가 구성된 경우에도 휴지통 폴더를 건너뛰어 파티션 데이터를 제거해야 합니다. 이 옵션은 관리형 테이블에만 적용됩니다. 다음과 같은 경우에만 적용됩니다.

  파일 시스템이 휴지통 폴더를 지원합니다. 삭제된 파티션을 휴지통 폴더로 이동하기 위해 카탈로그가 구성되었습니다. AWS S3에는 휴지통 폴더가 없으므로 적용되지 않습니다.

  파티션을 삭제한 후 파일을 수동으로 삭제할 필요가 없습니다.

RENAME PARTITION 조항

파티션의 키를 바꿉니다.

Delta Lake 테이블에는 파티션 관리가 지원되지 않습니다.

구문

from_partition_clause RENAME TO to_partition_clause

매개 변수

• from_partition_clause

  이름을 바꿀 파티션의 정의입니다.

• to_partition_clause

  이 파티션에 대한 새 정의입니다. 이미 키가 같은 파티션이 존재하지 않아야 합니다.

RECOVER PARTITIONS 조항

이 절은 Delta Lake 테이블에 적용되지 않습니다.

Azure Databricks에 테이블의 위치를 검색하고 파일 시스템에 직접 추가된 모든 파일을 테이블에 추가하도록 지시합니다.

Delta Lake 테이블에는 파티션 관리가 지원되지 않습니다.

구문

RECOVER PARTITIONS

매개 변수

없음

PARTITION SET LOCATION 절

파티션의 위치를 이동합니다.

Delta Lake 테이블에는 파티션 관리가 지원되지 않습니다.

구문

PARTITION clause SET LOCATION path

매개 변수

• PARTITION 절

  위치를 변경할 파티션을 식별합니다.

• LOCATION path

  path는 STRING 리터럴로 있어야 합니다. 파티션의 새 위치를 지정합니다.

  원래 위치의 파일은 새 위치로 이동되지 않습니다.

예제

ALTER TABLE 예제를 참조하세요.

관련된 문서

• ALTER TABLE