Sdílet prostřednictvím


ALTER TABLE ... PARTITION

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto 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 }

klauzule ADD PARTITION

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 oddílových klíčů.

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

klauzule DROP PARTITION

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á zrušit. 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ě.

klauzule RENAME PARTITION

Nahrazuje klíče oddílu.

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

Syntaxe

from_partition_clause RENAME TO to_partition_clause

Parametry

klauzule RECOVER PARTITIONS

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

PARTITION SET Klauzule umístění

Přesune oddíl na jiné místo.

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.