Edit

Share via

sp_renamedb (Transact-SQL)

  • Article

Applies to: SQL Server Azure SQL Managed Instance

Changes the name of a database.

Important

This feature will be removed in a future version of SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use ALTER DATABASE MODIFY NAME instead. For more information, see ALTER DATABASE.

Transact-SQL syntax conventions

Syntax

syntaxsql 
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.

SQL 
USE master;
GO

CREATE DATABASE Accounting;
GO

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

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

Related content