Udostępnij za pośrednictwem

ALTER TABLE ... PARTITION

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Dodaje, usuwa, zmienia nazwy lub odzyskuje partycje table.

Zarządzanie partycjami nie jest obsługiwane w przypadku usługi Delta Lake tables.

Składnia

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

ADD PARTITION klauzula

Dodaje jedną lub więcej partycji do table.

Zarządzanie partycjami nie jest obsługiwane w przypadku usługi Delta Lake tables.

Składnia

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

Parameters

  • IF NOT EXISTS

    Klauzula opcjonalna kierująca usługę Azure Databricks do ignorowania instrukcji, jeśli partition już istnieje.

  • PARTITION klauzula

    partition do dodania. Klucze partition muszą być zgodne z partycjonowaniem table i być skojarzone z values. Jeśli partition już istnieje, zostanie zgłoszony błąd, chyba że określono IF NOT EXISTS.

  • LOCATION path

    path musi być literałem STRING reprezentującym opcjonalne miejsce wskazujące na partition.

    Jeśli nie określono lokalizacji, zostanie ona ustalona na podstawie miejsca, gdzie znajdują się klucze table i partition.

    Jeśli w lokalizacji znajdują się pliki, wypełniają partition i muszą być zgodne z data_sourcetable oraz jego opcjami.

DROP PARTITION klauzula

Usuwa jedną lub więcej partycji z table, opcjonalnie usuwając dowolne pliki znajdujące się w lokalizacjach partycji.

Zarządzanie partycjami nie jest obsługiwane w przypadku usługi Delta Lake tables.

Składnia

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

Parameters

  • IF EXISTS

    Po określeniu IF EXISTS usługi Azure Databricks zignoruje próbę porzucenia partycji, które nie istnieją. W przeciwnym razie nie istniejące partycje spowodują błąd.

  • PARTITION klauzula

    Określa partition do usunięcia. Jeśli partition jest tylko częściowo identyfikowany, wycinek partycji zostanie porzucony.

  • PURGE

    Jeśli set, tablecatalog musi removepartition dane, pomijając folder Kosz nawet wtedy, gdy catalog został skonfigurowany. Ta opcja ma zastosowanie tylko w przypadku zarządzanych tables. Jest on skuteczny tylko wtedy, gdy:

    System plików obsługuje folder Kosza. catalog został skonfigurowany do przenoszenia porzuconych partition do folderu Kosz. W usłudze AWS S3 nie ma folderu Kosz, więc nie jest skuteczny.

    Po usunięciu partycji nie ma potrzeby ręcznego usuwania plików.

RENAME PARTITION klauzula

Zastępuje klucze partition.

Zarządzanie partycjami nie jest obsługiwane w przypadku usługi Delta Lake tables.

Składnia

from_partition_clause RENAME TO to_partition_clause

Parameters

RECOVER PARTITIONS klauzula

Ta klauzula nie ma zastosowania do usługi Delta Lake tables.

Nakazuje usłudze Azure Databricks skanowanie lokalizacji tablei dodawanie wszelkich plików do table, które zostały dodane bezpośrednio do systemu plików.

Zarządzanie partycjami nie jest obsługiwane w przypadku usługi Delta Lake tables.

Składnia

RECOVER PARTITIONS

Parameters

Brak

PARTITION SET klauzula LOKALIZACJA

Przenosi lokalizację partition.

Zarządzanie partycjami nie jest obsługiwane w przypadku usługi Delta Lake tables.

Składnia

PARTITION clause SET LOCATION path

Parameters

  • PARTITION klauzula

    Określa partition, dla których lokalizacja zostanie zmieniona.

  • LOCATION path

    path musi być literałem STRING . Określa nową lokalizację partition.

    Pliki w oryginalnej lokalizacji nie zostaną przeniesione do nowej lokalizacji.

Przykłady

Zobacz ALTER TABLE przykłady.