ALTER TABLE ODDÍL

  • Č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ů.

Syntaxe

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

Parametry

  • IF NOT EXISTS

    Nepovinná klauzule, která nasměruje Azure Databricks, aby příkaz ignoroval, pokud oddíl již existuje.

  • Klauzule PARTITION

    Přidá se oddíl. Klíče oddílů musí odpovídat dělení tabulky a musí být přidružené k hodnotám. Pokud oddíl již existuje, je vyvolána chyba, pokud IF NOT EXISTS nebyl zadán.

  • LOCATION path

    path musí být STRING literál 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í, kde jsou soubory, naplní oddíl a musí být kompatibilní s tabulkou a jejími možnostmi data_source .

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ů.

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.

  • Klauzule PARTITION

    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ů vynecháním složky Koš, i když katalog nakonfiguroval. 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.

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ů.

Syntaxe

RECOVER PARTITIONS

Parametry

Nic

Klauzule PARTITION SET LOCATION

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

Syntaxe

PARTITION clause SET LOCATION path

Parametry

  • Klauzule PARTITION

    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

Viz příklady ALTER TABLE.