sp_renamedb (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

Cambia el nombre de una base de datos.

Importante

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

Convenciones 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 sysname, sin ningún valor predeterminado.

[ @newname = ] 'new_name' Es el nuevo nombre de la base de datos. new_name deben seguir las reglas de los identificadores. new_name es sysname, sin ningún valor predeterminado.

Valores de código de retorno

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

Comentarios

No es posible cambiar el nombre de una base de datos de Azure SQL configurada en una relación de replicación geográfica activa.

Permisos

Requiere la pertenencia a los roles fijos 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  

Pasos siguientes