Skip to content

rename-tables-database-engine.md

Latest commit

 

History

History
85 lines (55 loc) · 3.41 KB

rename-tables-database-engine.md

File metadata and controls

85 lines (55 loc) · 3.41 KB
title Rename Tables (Database Engine) | Microsoft Docs
ms.custom
ms.date 02/23/2018
ms.prod sql
ms.prod_service table-view-index, sql-database, sql-data-warehouse, pdw
ms.reviewer
ms.technology table-view-index
ms.topic conceptual
helpviewer_keywords
table renaming [SQL Server]
table names [SQL Server]
tables [SQL Server], Visual Database Tools
renaming tables
author stevestein
ms.author sstein
monikerRange =azuresqldb-current||>=sql-server-2016||=sqlallproducts-allversions||>=sql-server-linux-2017||=azuresqldb-mi-current

Rename Tables (Database Engine)

[!INCLUDEtsql-appliesto-ss2016-asdb-xxxx-xxx-md]

Rename a table in SQL Server or Azure SQL Database.

To rename a table in Azure SQL Data Warehouse or Parallel Data Warehouse, use the t-sql RENAME OBJECT statement.

Caution

Think carefully before you rename a table. If existing queries, views, user-defined functions, stored procedures, or programs refer to that table, the name modification will make these objects invalid.

In This Topic

Before You Begin

Limitations and Restrictions

Renaming a table will not automatically rename references to that table. You must manually modify any objects that reference the renamed table. For example, if you rename a table and that table is referenced in a trigger, you must modify the trigger to reflect the new table name. Use sys.sql_expression_dependencies to list dependencies on the table before renaming it.

Security

Permissions

Requires ALTER permission on the table.

Using SQL Server Management Studio

To rename a table

  1. In Object Explorer, right-click the table you want to rename and choose Design from the shortcut menu.

  2. From the View menu, choose Properties.

  3. In the field for the Name value in the Properties window, type a new name for the table.

  4. To cancel this action, press the ESC key before leaving this field.

  5. From the File menu choose Save table name.

Using Transact-SQL

To rename a table

  1. In Object Explorer, connect to an instance of [!INCLUDEssDE].

  2. On the Standard bar, click New Query.

  3. The following example renames the SalesTerritory table to SalesTerr in the Sales schema. Copy and paste the following example into the query window and click Execute.

    USE AdventureWorks2012;   
GO  
EXEC sp_rename 'Sales.SalesTerritory', 'SalesTerr';

For additional examples, see sp_rename (Transact-SQL).