TRUNCATE TABLE

Van toepassing op: Databricks SQL Databricks Runtime

Hiermee verwijdert u alle rijen uit een tabel of partitie(s). De tabel mag geen weergave of tijdelijke tabel zijn. Delta Lake-tabellen kunnen worden afgekapt, of ze nu beheerd of extern zijn. Voor andere tabelformaten, zoals Parquet, CSV of ORC, mag de tabel niet extern zijn. Om meerdere partities tegelijk af te kappen, specificeer je de partities in partition_spec. Als er geen wordt partition_spec opgegeven, worden alle partities in de tabel verwijderd.

Als de tabel in de cache is opgeslagen, worden met de opdracht gegevens in de cache van de tabel en alle afhankelijke gegevens gewist die ernaar verwijzen. De cache wordt automatisch gevuld wanneer de tabel of de afhankelijke items de volgende keer worden benaderd.

Syntaxis

TRUNCATE TABLE table_name [ PARTITION clause ]

Parameters

• table_name

  De naam van de tabel die moet worden getrunceerd. De naam mag geen tijdelijke specificatie of optiesspecificatie bevatten. Als de tabel niet kan worden gevonden, genereert Azure Databricks een TABLE_OR_VIEW_NOT_FOUND-fout.

• PARTITION clausule

  Optionele specificatie van een partitie. Niet ondersteund voor Delta Lake.

Voorbeelden

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

Verwante artikelen:

• DROP TABLE
• ALTER TABLE
• PARTITION