Partage via

ALTER TABLE PARTITION

  • Article

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Permet d’ajouter des partitions à une table, de les supprimer, de les renommer ou de les récupérer.

La gestion des partitions n’est pas prise en charge pour les tables Delta Lake.

Syntaxe

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

Clause ADD PARTITION

Ajoute une ou plusieurs partitions à la table.

Syntaxe

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

Paramètres

  • IF NOT EXISTS

    Clause facultative dirigeant Azure Databricks pour ignorer l’instruction si la partition existe déjà.

  • Clause PARTITION

    Partition à ajouter. Les clés de partition doivent correspondre au partitionnement de la table et être associées aux valeurs. Si la partition existe déjà, une erreur est générée sauf si IF NOT EXISTS a été spécifié.

  • LOCATION path

    path doit être un littéral STRING qui représente un emplacement facultatif pointant vers la partition.

    Si aucun emplacement n’est spécifié, l’emplacement est dérivé de l’emplacement de la table et des clés de partition.

    Si des fichiers se trouvent à l’emplacement, ils remplissent la partition et doivent être compatibles avec le data_source de la table et ses options.

Clause DROP PARTITION

Supprime une ou plusieurs partitions de la table, en supprimant éventuellement les fichiers aux emplacements des partitions.

Syntaxe

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

Paramètres

  • IF EXISTS

    Lorsque vous spécifiez IF EXISTS, Azure Databricks ignore une tentative de suppression de partitions qui n’existent pas. Dans le cas contraire, les partitions non existantes provoquent une erreur.

  • Clause PARTITION

    Spécifie une partition à supprimer. Si la partition n’est que partiellement identifiée, une section de partitions est supprimée.

  • PURGE

    Si cette valeur est définie, le catalogue de tables doit supprimer les données de partition en ignorant le dossier de la corbeille même si le catalogue en a configuré un. L’option s’applique uniquement aux tables managées. Elle est effective uniquement dans les cas suivants :

    Le système de fichiers prend en charge un dossier Corbeille. Le catalogue a été configuré pour déplacer la partition supprimée dans le dossier Corbeille. Il n’y a aucun dossier Corbeille dans AWS S3, il n’est donc pas effectif.

    Il n’est pas nécessaire de supprimer manuellement des fichiers après la suppression des partitions.

Clause RENAME PARTITION

Remplace les clés d’une partition.

Syntaxe

from_partition_clause RENAME TO to_partition_clause

Paramètres

Clause RECOVER PARTITIONS

Cette clause ne s’applique pas aux tables Delta Lake.

Demande à Azure Databricks d’analyser l’emplacement de la table et d’ajouter des fichiers à la table qui ont été ajoutés directement au système de fichiers.

Syntaxe

RECOVER PARTITIONS

Paramètres

Aucune

Clause PARTITION SET LOCATION

Déplace l’emplacement d’une partition.

Syntaxe

PARTITION clause SET LOCATION path

Paramètres

  • Clause PARTITION

    Identifie la partition pour laquelle l’emplacement sera modifié.

  • LOCATION path

    path doit être un littéral STRING. Spécifie le nouvel emplacement de la partition.

    Les fichiers situés à l’emplacement d’origine ne seront pas déplacés vers le nouvel emplacement.

Exemples

Consulter les exemples d’ALTER TABLE.