Skip to content

sp-renamedb-transact-sql.md

Latest commit

 

History

History
90 lines (65 loc) · 2.57 KB

sp-renamedb-transact-sql.md

File metadata and controls

90 lines (65 loc) · 2.57 KB
title sp_renamedb (Transact-SQL)
description sp_renamedb changes the name of a database.
author markingmyname
ms.author maghan
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice system-objects
ms.topic reference
f1_keywords
sp_renamedb
sp_renamedb_TSQL
helpviewer_keywords
sp_renamedb
dev_langs
TSQL

sp_renamedb (Transact-SQL)

[!INCLUDE SQL Server - ASDBMI]

Changes the name of a database.

Important

[!INCLUDE ssNoteDepFutureAvoid] Use ALTER DATABASE MODIFY NAME instead. For more information, see ALTER DATABASE.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sp_renamedb
    [ @dbname = ] N'dbname'
    , [ @newname = ] N'newname'
[ ; ]

Arguments

[ @dbname = ] N'dbname'

The current name of the database. @dbname is sysname, with no default.

[ @newname = ] N'newname'

The new name of the database. @newname is sysname, with no default. @newname must follow the rules for identifiers.

Return code values

0 (success) or a nonzero number (failure).

Remarks

It isn't possible to rename an Azure SQL database configured in an active geo-replication relationship.

Permissions

Requires membership in the sysadmin or dbcreator fixed server roles.

Examples

The following example creates the Accounting database and then changes the name of the database to Financial. The sys.databases catalog view is then queried to verify the new name of the database.

USE master;
GO

CREATE DATABASE Accounting;
GO

EXECUTE sp_renamedb N'Accounting', N'Financial';
GO

SELECT name,
       database_id,
       create_date
FROM sys.databases
WHERE name = N'Financial';
GO

Related content