Sdílet prostřednictvím

ALTER TABLE ... PARTITION

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Přidá, zahodí, přejmenuje nebo obnoví oddíly tabulky.

Správa oddílů není pro tabulky Delta Lake podporovaná.

Syntaxe

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

ADD PARTITION klauzule

Přidá do tabulky jeden nebo více oddílů.

Správa oddílů není pro tabulky Delta Lake podporovaná.

Syntaxe

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

Parametry

  • IF NOT EXISTS

    Nepovinná klauzule, která určuje, aby Azure Databricks ignoroval příkaz, pokud oddíl již existuje.

  • PARTITION klauzule

    Oddíl, který má být přidán. Klíče oddílů musí odpovídat particionování tabulky a být spojeny s hodnotami. Pokud oddíl již existuje, je vyvolána chyba, pokud není zadán IF NOT EXISTS.

  • LOCATION path

    path musí být literál STRING představující volitelné umístění odkazující na oddíl.

    Pokud není zadáno žádné umístění, bude umístění odvozeno z umístění tabulky a klíčů oddílu.

    Pokud jsou v umístění soubory, zaplní oddíl a musí být kompatibilní s data_source tabulky a jejími možnostmi.

DROP PARTITION klauzule

Zahodí jeden nebo více oddílů z tabulky, případně odstraní všechny soubory v umístěních oddílů.

Správa oddílů není pro tabulky Delta Lake podporovaná.

Syntaxe

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

Parametry

  • IF EXISTS

    Když zadáte IF EXISTS Azure Databricks, bude ignorovat pokus o vyřazení oddílů, které neexistují. Jinak neexistující oddíly způsobí chybu.

  • PARTITION klauzule

    Určuje oddíl, který se má zahodit. Pokud je oddíl identifikován pouze částečně, část oddílů se zahodí.

  • PURGE

    Pokud je nastavený, katalog tabulek musí odebrat data oddílů tím, že přeskočí složku Koše, i když byl katalog nakonfigurován. Možnost je použitelná pouze pro spravované tabulky. Platí pouze v případech, kdy:

    Systém souborů podporuje složku Koš. Katalog byl nakonfigurován pro přesunutí vyřazeného oddílu do složky Koš. V AWS S3 není žádná složka koše, takže není efektivní.

    Po vyřazení oddílů nemusíte soubory odstraňovat ručně.

RENAME PARTITION klauzule

Nahradí klíče oddílu.

Správa oddílů není pro tabulky Delta Lake podporovaná.

Syntaxe

from_partition_clause RENAME TO to_partition_clause

Parametry

RECOVER PARTITIONS klauzule

Tato klauzule se nevztahuje na tabulky Delta Lake.

Dává Službě Azure Databricks pokyn, aby naskenoval umístění tabulky a přidal do tabulky všechny soubory, které byly přidány přímo do systému souborů.

Správa oddílů není pro tabulky Delta Lake podporovaná.

Syntaxe

RECOVER PARTITIONS

Parametry

Nic

klauzule umístění PARTITIONSET

Přesune umístění oddílu.

Správa oddílů není pro tabulky Delta Lake podporovaná.

Syntaxe

PARTITION clause SET LOCATION path

Parametry

  • PARTITION klauzule

    Identifikuje oddíl, pro který se bude umístění měnit.

  • LOCATION path

    path musí být STRING literál. Určuje nové umístění oddílu.

    Soubory v původním umístění nebudou přesunuty do nového umístění.

Příklady

Vizte ALTER TABLE příklady.