Freigeben über


sp_renamedb (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

Ändert den Namen einer Datenbank.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen ALTER DATABASE MODIFY NAME. Weitere Informationen finden Sie unter ALTER DATABASE.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @dbname = ] N'dbname'

Der aktuelle Name der Datenbank. @dbname ist "sysname" ohne Standard.

[ @newname = ] N'newname'

Der neue Name der Datenbank. @newname ist "sysname" ohne Standard. @newname müssen den Regeln für Bezeichner entsprechen.

Rückgabecodewerte

0 (Erfolg) oder eine Nichtzeronummer (Fehler).

Hinweise

Es ist nicht möglich, eine Azure SQL-Datenbank, die in einer aktiven Georeplikationsbeziehung konfiguriert ist, umzubenennen.

Berechtigungen

Erfordert die Mitgliedschaft in den festen Serverrollen "sysadmin " oder "dbcreator ".

Beispiele

Im folgenden Beispiel wird die Accounting-Datenbank erstellt und der Name anschließend in Financial geändert. Danach wird eine Abfrage der sys.databases-Katalogsicht ausgeführt, um den Namen der Datenbank zu überprüfen.

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