ALTER TABLE ... PARTITION

Gäller för: Databricks SQL Databricks Runtime

Lägger till, släpper, byter namn på eller återställer partitioner i en tabell.

Det går inte att hantera partitioner för Delta Lake-tabeller.

Syntax

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

ADD PARTITION klausul

Lägger till en eller flera partitioner i tabellen.

Det går inte att hantera partitioner för Delta Lake-tabeller.

Syntax

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

Parametrar

• IF NOT EXISTS

  Ett valfritt villkor som instruerar Azure Databricks att ignorera instruktionen om partitionen redan finns.

• PARTITION-klausul

  En partition som ska läggas till. Partitionsnycklarna måste matcha partitioneringen av tabellen och associeras med värden. Om partitionen redan finns utlöses ett fel om inte IF NOT EXISTS har angetts.

• LOCATION path

  path måste vara en STRING literal som representerar en valfri plats som pekar på partitionen.

  Om ingen plats anges härleds platsen från platsen för tabellen och partitionsnycklarna.

  Om det finns filer på platsen fyller de partitionen och måste vara kompatibla med tabellens data_source och dess alternativ.

DROP PARTITION klausul

Tar bort en eller flera partitioner från tabellen, och du kan också ta bort alla filer på partitionernas platser.

Det går inte att hantera partitioner för Delta Lake-tabeller.

Syntax

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

Parametrar

• IF EXISTS

  När du anger IF EXISTS Azure Databricks ignoreras ett försök att ta bort partitioner som inte finns. Annars orsakar icke-befintliga partitioner ett fel.

• PARTITION-klausul

  Anger en partition som ska tas bort. Om partitionen bara delvis identifieras tas en del av partitionerna bort.

• PURGE

  Om det anges måste tabellkatalogen ta bort partitionsdata genom att hoppa över papperskorgen även när katalogen har konfigurerat en. Alternativet gäller endast för hanterade tabeller. Den är endast effektiv när:

  Filsystemet stöder en papperskorg. Katalogen har konfigurerats för att flytta den borttagna partitionen till papperskorgen. Det finns ingen papperskorg i AWS S3, så den är inte effektiv.

  Du behöver inte ta bort filer manuellt efter att partitionerna har tagits bort.

RENAME PARTITION klausul

Ersätter nycklarna för en partition.

Det går inte att hantera partitioner för Delta Lake-tabeller.

Syntax

from_partition_clause RENAME TO to_partition_clause

Parametrar

• from_partition_clause

  Definitionen av partitionen som ska byta namn.

• to_partition_clause

  Den nya definitionen för den här partitionen. En partition med samma nycklar får inte redan finnas.

RECOVER PARTITIONS klausul

Den här satsen gäller inte för Delta Lake-tabeller.

Instruerar Azure Databricks att söka igenom tabellens plats och lägga till filer i tabellen som har lagts till direkt i filsystemet.

Det går inte att hantera partitioner för Delta Lake-tabeller.

Syntax

RECOVER PARTITIONS

Parametrar

Ingen

PARTITION SET platsklausul

Flyttar platsen för en partition.

Det går inte att hantera partitioner för Delta Lake-tabeller.

Syntax

PARTITION clause SET LOCATION path

Parametrar

• PARTITION-klausul

  Identifierar partitionen som platsen ska ändras för.

• LOCATION path

  path måste vara en STRING literal. Anger den nya platsen för partitionen.

  Filer på den ursprungliga platsen flyttas inte till den nya platsen.

Exempel

Se ALTER TABLE exempel.

Relaterade artiklar

• ALTER TABLE