-
Notifications
You must be signed in to change notification settings - Fork 29k
[SPARK-28799][DOC]Documentation for Truncate command #25557
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Closed
PavithraRamachandran
wants to merge
5
commits into
apache:master
from
PavithraRamachandran:truncate_doc
Closed
Changes from 4 commits
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
9d0ffb5
documentation for truncate command
PavithraRamachandran 00d37fd
documentation for truncate command- change
PavithraRamachandran 64c3254
updating truncate table document
PavithraRamachandran 5e32647
updating the review comments
PavithraRamachandran 39af010
review comment updation
PavithraRamachandran File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -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. Inorder to truncate multiple partitions at once, 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 | ||
| <dl> | ||
| <dt><code><em>table_name</em></code></dt> | ||
| <dd>The name of an existing table.</dd> | ||
| </dl> | ||
|
|
||
| <dl> | ||
| <dt><code><em>PARTITION ( partition_spec :[ partition_column = partition_col_value, partition_column = partition_col_value, ...] )</em></code></dt> | ||
| <dd>Specifies one or more partition column and value pairs. The partition value is optional.</dd> | ||
| </dl> | ||
|
|
||
|
|
||
| ### 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 is 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) | ||
|
|
||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Inorder -> In order
user -> the user
back-tick partition_spec