Help Center/ Data Warehouse Service / SQL Syntax Reference/ SQL Syntax Reference (9.1.1.x)/ DDL Syntax/ Tables and External Data Sources/ RENAME TABLE
Updated on 2026-01-06 GMT+08:00
View PDF
Share

RENAME TABLE

Function

RENAME TABLE renames a specified table.

RENAME TABLE has the same function as the following command:

1
 
ALTER TABLE table_name RENAME to new_table_name

Precautions

Tables cannot be renamed across schemas.

Syntax

1
2
 
RENAME TABLE
{[schema.]table_name TO new_table_name} [, ...];

Parameter Description

Table 1 RENAME TABLE parameters

Parameter

Description

Value Range

schema

Specifies the schema name.

-

table_name

Specifies the name of the table to be modified.

-

new_table_name

Specifies the new table name.

-

Examples

Rename a table:

1
 
RENAME TABLE customer_address TO new_customer_address;

Helpful Links

CREATE TABLE, ALTER TABLE, DROP TABLE

Parent Topic: Tables and External Data Sources