sp_renamedb (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure 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

Nächste Schritte