Help Center/ GaussDB(DWS)/ SQL Syntax Reference (8.1.3.x)/ DDL Syntax/ RENAME TABLE
Updated on 2024-12-19 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} [, ...];

Parameters

  • 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

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, and DROP TABLE

Parent topic: DDL Syntax