ALTER TABLE PARTITION

Se aplica a: Databricks SQL Databricks Runtime

Agrega, quita, cambia el nombre o recupera particiones de una tabla.

No se admite la administración de particiones para tablas de Delta Lake.

Sintaxis

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

ADD PARTITION clause

Agrega una o varias particiones a la tabla.

Sintaxis

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

Parámetros

• IF NOT EXISTS

  Cláusula opcional que indica a Azure Databricks que omita la instrucción si ya existe la partición.

• Cláusula PARTITION

  Partición que se va a agregar. Las claves de partición deben coincidir con la creación de particiones de la tabla y estar asociadas a valores. Si la partición ya existe, se genera un error a menos que IF NOT EXISTS se haya especificado.

• LOCATION path

  path debe ser un literal STRING que represente una ubicación opcional que apunte a la partición.

  Si no se especifica ninguna ubicación, esta derivará de la ubicación de la tabla y las claves de partición.

  Si hay archivos presentes en la ubicación, rellenan la partición y deben ser compatibles con el data_source de la tabla y sus opciones.

DROP PARTITION clause

Anula una o varias particiones de la tabla y, opcionalmente, elimina los archivos en las ubicaciones de las particiones.

Sintaxis

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

Parámetros

• IF EXISTS

  Al especificar IF EXISTS, Azure Databricks omite el intento de anular particiones que no existen. De lo contrario, las particiones no existentes producirán un error.

• Cláusula PARTITION

  Especifica una partición que se va a anular. Si la partición solo se identifica parcialmente, se anula un segmento de particiones.

• PURGE

  Si se establece, el catálogo de tablas debe quitar los datos de partición mediante la omisión de la carpeta Papelera aunque el catálogo la haya configurado. La opción solo es aplicable a las tablas administradas. Solo es eficaz cuando:

  El sistema de archivos admite una carpeta Papelera. El catálogo se ha configurado para trasladar la partición descartada a la carpeta Papelera. No hay ninguna carpeta Papelera en AWS S3, por lo que no es eficaz.

  No es necesario eliminar manualmente los archivos después de quitar particiones.

RENAME PARTITION clause

Reemplaza las claves de una partición.

Sintaxis

from_partition_clause RENAME TO to_partition_clause

Parámetros

• from_partition_clause

  Definición de la partición cuyo nombre se va a cambiar.

• to_partition_clause

  Nueva definición de esta partición. No debe existir ya una partición con las mismas claves.

RECOVER PARTITIONS clause

Esta cláusula no se aplica a las tablas de Delta Lake.

Indica a Azure Databricks que examine la ubicación de la tabla y agregue los archivos que se hayan agregado directamente al sistema de archivos a la tabla.

Sintaxis

RECOVER PARTITIONS

Parámetros

None

Cláusula PARTITION SET LOCATION

Traslada la ubicación de una partición.

Sintaxis

PARTITION clause SET LOCATION path

Parámetros

• Cláusula PARTITION

  Identifica la partición para la que se cambiará la ubicación.

• LOCATION path

  path debe ser un literal de STRING. Especifica la nueva ubicación para la partición.

  Los archivos de la ubicación original no se trasladarán a la nueva ubicación.

Ejemplos

Consulte los ejemplos de ALTER TABLE.

Artículos relacionados

• ALTER TABLE