sys.sp_renamedb (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Ändrar namnet på en databas.

Important

Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Använd ALTER DATABASE MODIFY NAME i stället. Mer information finns i ALTER DATABASE.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @dbname = ] N'dbname'

Det nuvarande namnet på databasen. @dbname är sysname, utan standard.

[ @newname = ] Inget nytt namn'

Det nya namnet på databasen. @newname är sysname, utan standard. @newname måste följa reglerna för identifierare.

Returnera kodvärden

0 (lyckades) eller ett icke-nolltal (fel).

Remarks

Det går inte att byta namn på en Azure SQL-databas som konfigurerats i en aktiv geo-replikering relation.

Permissions

Kräver medlemskap i sysadmin- eller dbcreator-fasta serverroller.

Examples

Följande exempel skapar databasen Accounting och ändrar sedan namnet på databasen till Financial. Katalogvyn sys.databases frågas sedan för att verifiera det nya namnet på databasen.

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