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 }

cláusula ADD PARTITION

Agrega una o varias particiones a la tabla.

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

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.

• PARTITION cláusula

  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.

cláusula DROP PARTITION

Quita una o varias particiones de la tabla, eliminando opcionalmente los archivos en las ubicaciones de las particiones.

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

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.

• PARTITION cláusula

  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.

cláusula RENAME PARTITION

Reemplaza las claves de una partición.

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

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.

cláusula RECOVER PARTITIONS

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 a la tabla que se han agregado directamente al sistema de archivos.

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

Sintaxis

RECOVER PARTITIONS

Parámetros

Ninguno

PARTITION SET Cláusula de Ubicación

Traslada la ubicación de una partición.

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

Sintaxis

PARTITION clause SET LOCATION path

Parámetros

• PARTITION cláusula

  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 ALTER TABLE ejemplos.

Artículos relacionados

• ALTER TABLE