다음을 통해 공유

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 절

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

구문

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 절

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

구문

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

매개 변수

  • IF EXISTS

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

  • PARTITION 절

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

  • PURGE

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

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

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

RENAME PARTITION 절

파티션의 키를 바꿉니다.

구문

from_partition_clause RENAME TO to_partition_clause

매개 변수

RECOVER PARTITIONS 절

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

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

구문

RECOVER PARTITIONS

매개 변수

None

PARTITION SET LOCATION 절

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

구문

PARTITION clause SET LOCATION path

매개 변수

  • PARTITION 절

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

  • LOCATION path

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

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

예제

ALTER TABLE 예제를 참조하세요.