sys.sp_renamedb (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Muda o nome de uma base de dados.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Utilize ALTER DATABASE MODIFY NAME em substituição. Para obter mais informações, veja ALTER DATABASE.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_renamedb
    [ @dbname = ] N'dbname'
    , [ @newname = ] N'newname'
[ ; ]

Arguments

[ @dbname = ] N'dbname'

O nome atual da base de dados. @dbname é sysname, sem padrão.

[ @newname = ] N'novo nome'

O novo nome da base de dados. @newname é sysname, sem padrão. @newname deve seguir as regras para identificadores.

Valores de código de retorno

0 (sucesso) ou um número diferente de zero (falha).

Remarks

Não é possível renomear um banco de dados SQL do Azure configurado em uma relação de de replicação geográfica ativa.

Permissions

Requer a pertença aos papéis fixos de servidor de sysadmin ou dbcreator .

Examples

O exemplo seguinte cria a Accounting base de dados e depois altera o nome da base para Financial. A sys.databases vista de catálogo é então consultada para verificar o novo nome da base de dados.

USE master;
GO

CREATE DATABASE Accounting;
GO

EXECUTE sp_renamedb N'Accounting', N'Financial';
GO

SELECT name,
       database_id,
       create_date
FROM sys.databases
WHERE name = N'Financial';
GO

Conteúdo relacionado

  • Last updated on