TRUNCATE TABLE

Область применения: Databricks SQL Databricks Runtime

Удаляет все строки из таблицы или секций. Стол не должен быть видом или временным столом. Таблицы Дельта-Лейк можно урезать как управляемые, так и внешние. Для других форматов таблиц, таких как Parquet, CSV или ORC, таблица не должна быть внешней. Чтобы урезать несколько разделов одновременно, закажите разделы в partition_spec. Если нет partition_spec указано, все разделы из таблицы удаляются.

Примечание.

Delta Lake не поддерживает условия секций для TRUNCATE.

Если таблица кэшируется, команда очищает кэшированные данные таблицы и все зависимые от нее данные. Кэш будет заполнен по мере необходимости, при следующем обращении к таблице или зависимым.

Синтаксис

TRUNCATE TABLE table_name [ PARTITION clause ]

Параметры

• table_name

  Имя таблицы для усечения. Имя не должно включать темпоральную спецификацию или спецификацию опций. Если таблица не найдена, Azure Databricks вызывает ошибку TABLE_OR_VIEW_NOT_FOUND.

• предложение PARTITION

  Необязательная спецификация раздела. Не поддерживается для Delta Lake.

Примеры

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

Связанные статьи

• DROP TABLE
• ALTER TABLE
• PARTITION