sp_renamedb (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstâ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. Em vez disso, use ALTER DATABASE MODIFY NAME. Para obter mais informações, veja ALTER DATABASE (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

[ @dbname = ] 'old_name' É o nome atual do banco de dados. old_name é sysname, sem padrão.

[ @newname = ] 'new_name' É o novo nome do banco de dados. new_name deve seguir as regras para identificadores. new_name é sysname, sem padrão.

Valores do código de retorno

0 (êxito) 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 às 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, modified_date  
FROM sys.databases  
WHERE name = N'Financial';  
GO

Próximas etapas