sp_renamedb (Transact-SQL)

Cambia el nombre de una base de datos.

Nota importanteImportante

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, utilice ALTER DATABASE MODIFY NAME. Para obtener más información, vea ALTER DATABASE (Transact-SQL).

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_renamedb [ @dbname = ] 'old_name' , [ @newname = ] 'new_name'

Argumentos

  • [ @dbname=] 'old_name'
    Es el nombre actual de la base de datos. old_name es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @newname=] 'new_name'
    Es el nuevo nombre de la base de datos. new_name debe cumplir las reglas de los identificadores. new_name es de tipo sysname y no tiene valor predeterminado.

Valores de código de retorno

0 (correcto) o número distinto de cero (error)

Permisos

Debe pertenecer a las funciones fijas de servidor sysadmin o dbcreator.

Ejemplos

El siguiente ejemplo crea la base de datos Accounting y, a continuación, cambia el nombre de la base de datos a Financial. La vista de catálogo sys.databases se consulta entonces para comprobar el nuevo nombre de la base de datos.

USE master;
GO
CREATE DATABASE Accounting;
GO
EXEC sp_renamedb N'Accounting', N'Financial';
GO
SELECT name, database_id, modified_date
FROM sys.databases
WHERE name = N'Financial';
GO