Condividi tramite

ALTER TABLE ... PARTITION

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Aggiunge, elimina, rinomina o recupera le partizioni di un table.

La gestione delle partizioni non è supportata per Delta Lake tables.

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 al table.

La gestione delle partizioni non è supportata per Delta Lake tables.

Sintassi

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

Parameters

  • IF NOT EXISTS

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

  • PARTITION clausola

    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 letterale STRING 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.

Clausola DROP PARTITION

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.

Sintassi

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

Parameters

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

Clausola RENAME PARTITION

Sostituisce le chiavi di un partition.

La gestione delle partizioni non è supportata per Delta Lake tables.

Sintassi

from_partition_clause RENAME TO to_partition_clause

Parameters

Clausola RECOVER PARTITIONS

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.

Sintassi

RECOVER PARTITIONS

Parameters

None

clausola PARTITIONSET LOCATION

Sposta la posizione di un partition.

La gestione delle partizioni non è supportata per Delta Lake tables.

Sintassi

PARTITION clause SET LOCATION path

Parameters

  • PARTITION clausola

    Identifica il partition per il quale verrà modificata la posizione.

  • LOCATION path

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

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

Esempi

Vedi ALTER TABLE esempi.