sp_renamedb (Transact-SQL)

發行項
03/07/2014

變更資料庫的名稱。

重要事項
未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。請改用 ALTER DATABASE MODIFY NAME。如需詳細資訊，請參閱＜ALTER DATABASE (Transact-SQL)＞。

適用於：SQL Server (SQL Server 2008 至目前版本)。

主題連結圖示 Transact-SQL 語法慣例

語法

sp_renamedb [ @dbname = ] 'old_name' , [ @newname = ] 'new_name'

引數

[ @dbname=] 'old_name'
這是資料庫的目前名稱。 old_name 是 sysname，沒有預設值。
[ @newname=] 'new_name'
這是資料庫的新名稱。 new_name 必須遵照識別碼的規則。 new_name 是 sysname，沒有預設值。

傳回碼值

0 (成功) 或非零數字 (失敗)

權限

需要 sysadmin 或 dbcreator 固定伺服器角色中的成員資格。

範例

下列範例會建立 Accounting 資料庫，再將資料庫名稱改為 Financial。然後再查詢 sys.databases 目錄檢視，來驗證資料庫的新名稱。

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