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).
Transact-SQL-Syntaxkonventionen
Syntax
sp_renamedb [ @dbname = ] 'old_name' , [ @newname = ] 'new_name'
Argumente
[ @dbname = ] 'old_name'
Ist der aktuelle Name der Datenbank. old_name ist "sysname" ohne Standard.
[ @newname = ] 'new_name'
Ist der neue Name der Datenbank. new_name müssen den Regeln für Bezeichner entsprechen. new_name ist "sysname" ohne Standard.
Rückgabecodewerte
0 (Erfolg) oder eine Zahl ungleich Null (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, modified_date
FROM sys.databases
WHERE name = N'Financial';
GO