blob: 8797a64f8927f3b0599de92fd7b98bbe59486997 [file] [view]
---
{
"title": "ALTER TABLE RENAME",
"language": "en",
"description": "This statement is used to rename certain names of existing table properties. This operation is synchronous,"
}
---
## Description
This statement is used to rename certain names of existing table properties. This operation is synchronous, and the return of the command indicates the completion of the execution.
grammar:
```sql
ALTER TABLE [database.]table alter_clause;
```
The alter_clause of rename supports modification of the following names
1. Modify the table name
grammar:
```sql
RENAME new_table_name;
```
2. Modify the rollup index name
grammar:
```sql
RENAME ROLLUP old_rollup_name new_rollup_name;
```
3. Modify the partition name
grammar:
```sql
RENAME PARTITION old_partition_name new_partition_name;
```
4. Modify the column name
:::tip Tips
This feature is supported since the Apache Doris 1.2 version
:::
Modify the column name
grammar:
```sql
RENAME COLUMN old_column_name new_column_name;
```
Notice:
- When creating a table, you need to set 'light_schema_change=true' in the property.
## Example
1. Modify the table named table1 to table2
```sql
ALTER TABLE table1 RENAME table2;
```
2. Modify the rollup index named rollup1 in the table example_table to rollup2
```sql
ALTER TABLE example_table RENAME ROLLUP rollup1 rollup2;
```
3. Modify the partition named p1 in the table example_table to p2
```sql
ALTER TABLE example_table RENAME PARTITION p1 p2;
```
4. Modify the column named c1 in the table example_table to c2
```sql
ALTER TABLE example_table RENAME COLUMN c1 c2;
```
## Keywords
```text
ALTER, TABLE, RENAME, ALTER TABLE
```
## Best Practice