ALTER TABLE ... PARTITION
Si applica a: Databricks SQL
Databricks Runtime
Aggiunge, elimina, rinomina o recupera le partizioni di un table.
La gestione delle partizioni non è supportata per Delta Lake tables.
ALTER TABLE table_name
{ ADD PARTITION clause |
DROP PARTITION clause |
PARTITION SET LOCATION clause |
RENAME PARTITION clause |
RECOVER PARTITIONS clause }
Aggiunge una o più partizioni al table.
La gestione delle partizioni non è supportata per Delta Lake tables.
ADD [IF NOT EXISTS] { PARTITION clause [ LOCATION path ] } [...]
IF NOT EXISTS
Clausola facoltativa che indirizza Azure Databricks a ignorare l'istruzione se il partition esiste già.
-
Oggetto partition da aggiungere. Le chiavi di partition devono corrispondere al partizionamento del table e devono essere associate a values. Se il partition esiste già un errore viene generato a meno che non sia stato specificato
IF NOT EXISTS
. LOCATION path
path
deve essere un letteraleSTRING
che rappresenta una posizione facoltativa che punta al partition.Se non viene specificata alcuna posizione, la posizione verrà derivata dalla posizione dei tasti table e partition.
Se sono presenti file nel percorso, essi popolano il partition e devono essere compatibili con il
data_source
del table e le relative opzioni.
Elimina una o più partizioni dal table, eliminando facoltativamente tutti i file nei percorsi delle partizioni.
La gestione delle partizioni non è supportata per Delta Lake tables.
DROP [ IF EXISTS ] PARTITION clause [, ...] [PURGE]
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.-
Specifica un partition da eliminare. Se la partition viene identificata solo parzialmente, viene eliminata una sezione di partizioni.
PURGE
Se set, il tablecatalog deve removepartition i dati ignorando la cartella Cestino anche quando il catalog ne ha configurato uno. L'opzione è applicabile solo per i tablesgestiti. È efficace solo quando:
Il file system supporta una cartella Cestino. Il catalog è stato configurato per spostare il partition rimosso 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.
Sostituisce le chiavi di un partition.
La gestione delle partizioni non è supportata per Delta Lake tables.
from_partition_clause RENAME TO to_partition_clause
-
Definizione del partition da rinominare.
-
Nuova definizione per questo partition. Un partition con le stesse chiavi non deve già esistere.
Questa clausola non si applica a Delta Lake tables.
Indica ad Azure Databricks di analizzare il percorso del tablee aggiungere eventuali file al table aggiunti direttamente al file system.
La gestione delle partizioni non è supportata per Delta Lake tables.
RECOVER PARTITIONS
None
Sposta la posizione di un partition.
La gestione delle partizioni non è supportata per Delta Lake tables.
PARTITION clause SET LOCATION path
-
Identifica il partition per il quale verrà modificata la posizione.
LOCATION path
path
deve essere un valoreSTRING
letterale. Specifica la nuova posizione per il partition.I file nel percorso originale non verranno spostati nel nuovo percorso.
Vedi ALTER TABLE esempi.