RENAME

Purpose

Use the RENAME statement to rename a table, view, sequence, or private synonym for a table, view, or sequence.

• Oracle automatically transfers integrity constraints, indexes, and grants on the old object to the new object.

• Oracle invalidates all objects that depend on the renamed object, such as views, synonyms, and stored procedures and functions that refer to a renamed table.

Do not use this statement to rename public synonyms. Instead, drop the public synonym and then create another public synonym with the new name.

See Also: CREATE SYNONYM and DROP SYNONYM

Prerequisites

The object must be in your own schema.

Syntax

Keywords and Parameters

old

Specify the name of an existing table, view, sequence, or private synonym.

new

Specify the new name to be given to the existing object. The new name must not already be used by another schema object in the same namespace and must follow the rules for naming schema objects.

See Also: "Schema Object Naming Rules"

Example

Rename a Database Object Example

To change the name of table dept to emp_dept, issue the following statement:

RENAME dept TO emp_dept;

You cannot use this statement directly to rename columns. However, you can rename a column using this statement together with the CREATE TABLE statement with AS subquery. The following statements re-create the table static, renaming a column from oldname to newname:

CREATE TABLE temporary (newname, col2, col3) 
    AS SELECT oldname, col2, col3 FROM static; 

DROP TABLE static; 

RENAME temporary TO static;