Help Center/ Data Warehouse Service / SQL Syntax Reference (9.1.0.x)/ DDL Syntax/ RENAME TABLE
Updated on 2025-09-18 GMT+08:00
View PDF

RENAME TABLE

Function

RENAME TABLE renames a specified table.

Precautions

RENAME TABLE has the same function as the following command:

1
 
ALTER TABLE table_name RENAME to new_table_name

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.

Valid schema name

table_name

Specifies the name of the table to be modified.

Name of an existing table

new_table_name

Specifies the new table name.

A string that must comply with the rules in Identifier Naming Conventions.

Examples

Create a column-store table and specify the storage format and compression mode.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
DROP TABLE IF EXISTS customer_address;
CREATE TABLE customer_address
(
    ca_address_sk       INTEGER                  NOT NULL   ,
    ca_address_id       CHARACTER(16)            NOT NULL   ,
    ca_street_number    CHARACTER(10)                       ,
    ca_street_name      CHARACTER varying(60)               ,
    ca_street_type      CHARACTER(15)                       ,
    ca_suite_number     CHARACTER(10)                    
)
WITH (ORIENTATION = COLUMN, COMPRESSION=HIGH,COLVERSION=2.0)
DISTRIBUTE BY HASH (ca_address_sk);

Rename a table.

1
 
RENAME TABLE customer_address TO new_customer_address;

Helpful Links

CREATE TABLE, ALTER TABLE, DROP TABLE

Parent Topic: DDL Syntax