sp_renamedb (Transact-SQL)
Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure
Altera o nome de um banco de dados
Importante
Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use o ALTER DATABASE MODIFY NAME
em vez disso. Para saber mais, confira ALTERAR BANCO DE DADOS.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_renamedb
[ @dbname = ] N'dbname'
, [ @newname = ] N'newname'
[ ; ]
Argumentos
@dbname [ = ] N'dbname'
O nome atual do banco de dados. @dbname é sysname, sem padrão.
@newname [ = ] N'novonome'
O novo nome do banco de dados. @newname é sysname, sem padrão. @newname deve seguir as regras para identificadores.
Valores do código de retorno
0
(sucesso) ou um número diferente de zero (falha).
Comentários
Não é possível renomear um banco de dados SQL do Azure configurado em uma relação de replicação geográfica ativa.
Permissões
Requer associação nas funções de servidor fixas sysadmin ou dbcreator.
Exemplos
O exemplo a seguir cria o banco de dados Accounting
e altera o seu nome para Financial
. Em seguida, a exibição de catálogo sys.databases
será consultada para verificar o novo nome do banco de dados.
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