TRUNCATE TABLE

Se aplica a: Databricks SQL Databricks Runtime

Quita todas las filas de una tabla o de las particiones. La tabla no debe ser una vista ni una tabla externa o temporal. Para truncar varias particiones a la vez, especifíquelas en partition_spec. Si no se especifica partition_spec, quita todas las particiones de la tabla.

Nota:

Delta Lake no admite cláusulas de partición para TRUNCATE.

Si la tabla se almacena en caché, el comando borra los datos almacenados en caché de la tabla y todos los elementos dependientes que hacen referencia a ella. La memoria caché se rellenará en diferido cuando se acceda a la tabla o a los elementos dependientes la próxima vez.

Sintaxis

TRUNCATE TABLE table_name [ PARTITION clause ]

Parámetros

• table_name

  Nombre de la tabla que se va a truncar. El nombre no debe incluir una especificación temporal. Si no se encuentra la tabla, Azure Databricks genera un error TABLE_OR_VIEW_NOT_FOUND.

• Cláusula PARTITION

  Especificación opcional de una partición. No se admite para Delta Lake.

Ejemplos

-- Create table Student with partition
> CREATE TABLE Student (name STRING, rollno INT) PARTITIONED BY (age INT);

> SELECT * FROM Student;
 name rollno age
 ---- ------ ---
  ABC      1  10
  DEF      2  10
  XYZ      3  12

-- Remove all rows from the table in the specified partition
> TRUNCATE TABLE Student partition(age=10);

-- After truncate execution, records belonging to partition age=10 are removed
> SELECT * FROM Student;
 name rollno age
 ---- ------ ---
  XYZ      3  12

-- Remove all rows from the table from all partitions
> TRUNCATE TABLE Student;

> SELECT * FROM Student;
 name rollno age
 ---- ------ ---

Artículos relacionados

• DROP TABLE
• ALTER TABLE
• PARTITION