Udostępnij za pomocą

ALTER TABLE ... PARTITION

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

Dodaje, usuwa, zmienia nazwy lub odzyskuje partycje tabeli.

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

Składnia

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

klauzula ADD PARTITION

Dodaje jedną lub więcej partycji do tabeli.

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

Składnia

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

Parametry

  • IF NOT EXISTS

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

  • PARTITION klauzula

    Partycja do dodania. Klucze partycji muszą być zgodne z partycjonowaniem tabeli i być skojarzone z wartościami. Jeśli partycja już istnieje, zostanie zgłoszony błąd, chyba że określono IF NOT EXISTS.

  • LOCATION path

    path musi być literałem STRING, który reprezentuje opcjonalną lokalizację, wskazującą na partycję.

    Jeśli nie zostanie określona lokalizacja, zostanie ona ustalona na podstawie lokalizacji tabeli i kluczy partycji.

    Jeśli w lokalizacji znajdują się pliki, to wypełniają one partycję i muszą być zgodne z data_source tabeli i jej opcjami.

klauzula DROP PARTITION

Usuwa co najmniej jedną partycję z tabeli, opcjonalnie usuwając wszystkie pliki w lokalizacjach partycji.

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

Składnia

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

Parametry

  • 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 partycję, która ma zostać porzucona. Jeśli partycja jest identyfikowana tylko częściowo, fragment partycji zostanie pominięty.

  • PURGE

    Jeśli jest ustawiony, wykaz tabel musi usunąć dane partycji, pomijając folder Kosz nawet wtedy, gdy wykaz został skonfigurowany. Ta opcja ma zastosowanie tylko w przypadku zarządzanych tabel. Jest on skuteczny tylko wtedy, gdy:

    System plików obsługuje folder Kosz. Wykaz został skonfigurowany do przenoszenia usuniętej partycji do folderu Kosz. W usłudze AWS S3 nie ma folderu Kosz, więc odzyskiwanie usuniętych danych nie jest skuteczne.

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

klauzula RENAME PARTITION

Zastępuje klucze partycji.

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

Składnia

from_partition_clause RENAME TO to_partition_clause

Parametry

klauzula RECOVER PARTITIONS

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

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

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

Składnia

RECOVER PARTITIONS

Parametry

Brak

PARTITION SET KLAUZULA LOKALIZACJI

Przenosi lokalizację partycji.

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

Składnia

PARTITION clause SET LOCATION path

Parametry

  • PARTITION klauzula

    Określa partycję, dla której lokalizacja ma zostać zmieniona.

  • LOCATION path

    path musi być dosłowną wartością STRING. Określa nową lokalizację partycji.

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

Przykłady

Zobacz ALTER TABLE przykłady.

  • Last updated on