다음을 통해 공유

ALTER TABLE ... PARTITION

  • 아티클

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime

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

Delta Lake tables대해 파티션 관리가 지원되지 않습니다.

구문

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

ADD PARTITION 절

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

Delta Lake tables대해 파티션 관리가 지원되지 않습니다.

구문

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

Parameters

  • IF NOT EXISTS

    partition가 이미 있는 경우, Azure Databricks가 명령문을 무시하도록 지시하는 선택적 절입니다.

  • PARTITION 절

    partition을(를) 추가하십시오. partition 키는 table 분할과 일치해야 하며 values와 연관되어야 합니다. partition 이미 있는 경우 IF NOT EXISTS 지정하지 않으면 오류가 발생합니다.

  • LOCATION path

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

    위치가 지정되지 않은 경우 위치는 table 위치 및 partition 키에서 파생됩니다.

    위치에 파일이 존재할 경우, 이 파일들은 partition에 반영되며 table의 data_source 및 해당 옵션과 호환되어야 합니다.

DROP PARTITION 절

table에서 하나 이상의 파티션을 삭제하며, 파티션의 위치에 있는 파일을 선택적으로 삭제할 수 있습니다.

Delta Lake tables대해 파티션 관리가 지원되지 않습니다.

구문

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

Parameters

  • IF EXISTS

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

  • PARTITION 절

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

  • PURGE

    set인 경우, catalog가 구성되어 있어도 tablecatalog는 휴지통 폴더를 건너뛰어 데이터를 removepartition해야 합니다. 이 옵션은 관리되는 tables경우에만 적용됩니다. 다음과 같은 경우에만 적용됩니다.

    파일 시스템이 휴지통 폴더를 지원합니다. catalog이 떨어뜨려진 partition을 휴지통 폴더로 이동하도록 구성되었습니다. AWS S3에는 휴지통 폴더가 없으므로 적용되지 않습니다.

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

RENAME PARTITION 절

partition키를 바꿉니다.

Delta Lake tables대해 파티션 관리가 지원되지 않습니다.

구문

from_partition_clause RENAME TO to_partition_clause

Parameters

  • from_partition_clause

    이름을 바꿀 partition의 정의입니다.

  • to_partition_clause

    이 partition의 새로운 정의입니다. 동일한 키를 가진 partition는 이미 존재해서는 안 됩니다.

RECOVER PARTITIONS 절

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

Azure Databricks에 table위치를 스캔하고 파일 시스템에 직접 추가된 파일들을 table에 추가하도록 지시합니다.

Delta Lake tables대해 파티션 관리가 지원되지 않습니다.

구문

RECOVER PARTITIONS

Parameters

None

PARTITION SET LOCATION 절

partition의 위치를 옮깁니다.

Delta Lake tables대해 파티션 관리가 지원되지 않습니다.

구문

PARTITION clause SET LOCATION path

Parameters

  • PARTITION 절

    위치가 변경될 partition을 식별합니다.

  • LOCATION path

    path는 STRING 리터럴이어야 합니다. partition의 새 위치를 지정하는 것입니다.

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

예제

ALTER TABLE 예제를 참조하세요.