ALTER TABLE ... PARTITION

Si applica a: Databricks SQL Databricks Runtime

Aggiunge, elimina, rinomina o recupera le partizioni di una tabella.

La gestione delle partizioni non è supportata per le tabelle Delta Lake.

Sintassi

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

clausola ADD PARTITION

Aggiunge una o più partizioni alla tabella.

La gestione delle partizioni non è supportata per le tabelle Delta Lake.

Sintassi

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

Parametri

• IF NOT EXISTS

  Clausola facoltativa che indirizza Azure Databricks a ignorare l'istruzione se la partizione esiste già.

• PARTITION clausola

  Partizione da aggiungere. Le chiavi di partizione devono corrispondere al partizionamento della tabella e devono essere associate ai valori. Se la partizione esiste già, viene generato un errore a meno che non IF NOT EXISTS sia stato specificato.

• LOCATION path

  path deve essere un STRING letterale che rappresenta una posizione facoltativa della partizione.

  Se non viene specificata alcuna posizione, la posizione verrà derivata dalla posizione della tabella e dalle chiavi di partizione.

  Se ci sono file presenti nel percorso, essi popolano la partizione e devono essere compatibili con la tabella data_source e le sue opzioni.

clausola DROP PARTITION

Elimina una o più partizioni dalla tabella, eliminando facoltativamente tutti i file nei percorsi delle partizioni.

La gestione delle partizioni non è supportata per le tabelle Delta Lake.

Sintassi

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

Parametri

• IF EXISTS

  Quando si specifica IF EXISTS Azure Databricks ignorerà un tentativo di eliminare partizioni che non esistono. In caso contrario, le partizioni non esistenti genereranno un errore.

• PARTITION clausola

  Specifica una partizione da eliminare. Se la partizione è identificata solo parzialmente, viene eliminata una sezione di partizioni.

• PURGE

  Se impostato, il catalogo tabelle deve rimuovere i dati della partizione ignorando la cartella Cestino anche quando il catalogo ne ha configurato uno. L'opzione è applicabile solo per le tabelle gestite. È efficace solo quando:

  Il file system supporta una cartella Cestino. Il catalogo è stato configurato per spostare la partizione eliminata nella cartella Cestino. Non esiste alcuna cartella Cestino in AWS S3, quindi non è efficace.

  Non è necessario eliminare manualmente i file dopo l'eliminazione delle partizioni.

clausola RENAME PARTITION

Sostituisce le chiavi di una partizione.

La gestione delle partizioni non è supportata per le tabelle Delta Lake.

Sintassi

from_partition_clause RENAME TO to_partition_clause

Parametri

• from_partition_clause

  Definizione della partizione da rinominare.

• to_partition_clause

  Nuova definizione per questa partizione. Una partizione con le stesse chiavi non deve esistere già.

clausola RECOVER PARTITIONS

Questa clausola non si applica alle tabelle Delta Lake.

Indica ad Azure Databricks di analizzare il percorso della tabella e aggiungere eventuali file alla tabella aggiunti direttamente al file system.

La gestione delle partizioni non è supportata per le tabelle Delta Lake.

Sintassi

RECOVER PARTITIONS

Parametri

Nessuno

PARTITION SET Clausola LOCATION

Sposta la posizione di una partizione.

La gestione delle partizioni non è supportata per le tabelle Delta Lake.

Sintassi

PARTITION clause SET LOCATION path

Parametri

• PARTITION clausola

  Identifica la partizione per cui verrà modificata la posizione.

• LOCATION path

  path deve essere un valore STRING letterale. Specifica la nuova posizione per la partizione.

  I file nel percorso originale non verranno spostati nel nuovo percorso.

Esempi

Vedi ALTER TABLE esempi.

Articoli correlati

• ALTER TABLE