sp_renamedb (Transact-SQL)

  • Artigo

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

Conteúdo relacionado