ALTER TABLE PARTYCJA

  • Artykuł

Dotyczy:check marked yes Databricks SQL check marked yes 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 }

ADD PARTITION Klauzula

Dodaje do tabeli co najmniej jedną partycję.

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.

  • KLAUZULA PARTITION

    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 IF NOT EXISTS został określony.

  • LOCATION path

    path musi być literałem reprezentującym STRING opcjonalną lokalizację wskazującą partycję.

    Jeśli nie określono lokalizacji, lokalizacja będzie pochodzić z lokalizacji tabeli i kluczy partycji.

    Jeśli istnieją pliki w lokalizacji, w której wypełniają partycję i muszą być zgodne z tabelą data_source i jej opcjami.

DROP PARTITION Klauzula

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

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.

  • KLAUZULA PARTITION

    Określa partycję, która ma zostać porzucona. Jeśli partycja jest identyfikowana tylko częściowo, część partycji zostanie porzucona.

  • PURGE

    W przypadku ustawienia 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 Kosza. Wykaz został skonfigurowany do przenoszenia usuniętej partycji 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 partycji.

Składnia

from_partition_clause RENAME TO to_partition_clause

Parametry

RECOVER PARTITIONS Klauzula

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.

Składnia

RECOVER PARTITIONS

Parametry

Brak

PARTITION SET LOCATION, klauzula

Przenosi lokalizację partycji.

Składnia

PARTITION clause SET LOCATION path

Parametry

  • KLAUZULA PARTITION

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

  • LOCATION path

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

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

Przykłady

Zobacz PRZYKŁADY ALTER TABLE.