diff --git a/docs/sql-ref-syntax-ddl-truncate-table.md b/docs/sql-ref-syntax-ddl-truncate-table.md index 2704259391e9..4b4094ab708e 100644 --- a/docs/sql-ref-syntax-ddl-truncate-table.md +++ b/docs/sql-ref-syntax-ddl-truncate-table.md @@ -19,4 +19,68 @@ license: | limitations under the License. --- -**This page is under construction** +### Description +The `TRUNCATE TABLE` statement removes all the rows from a table or partition(s). The table must not be a view +or an external/temporary table. In order to truncate multiple partitions at once, the user can specify the partitions +in `partition_spec`. If no `partition_spec` is specified it will remove all partitions in the table. + +### Syntax +{% highlight sql %} +TRUNCATE TABLE table_name [PARTITION partition_spec]; +{% endhighlight %} + +### Parameters +
+
table_name
+
The name of an existing table.
+
+ +
+
PARTITION ( partition_spec :[ partition_column = partition_col_value, partition_column = partition_col_value, ...] )
+
Specifies one or more partition column and value pairs. The partition value is optional.
+
+ + +### Examples +{% highlight sql %} + +--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 | ++-------+---------+------+--+ + +-- Removes all rows from the table in the partion specified +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 | ++-------+---------+------+--+ + +-- Removes all rows from the table from all partitions +TRUNCATE TABLE Student; + +SELECT * from Student; ++-------+---------+------+--+ +| name | rollno | age | ++-------+---------+------+--+ ++-------+---------+------+--+ +No rows selected + +{% endhighlight %} + + +### Related Statements +- [DROP TABLE](sql-ref-syntax-ddl-drop-table.html) +- [ALTER TABLE](sql-ref-syntax-ddl-alter-tabley.html) +