共用方式為


sp_renamedb (Transact-SQL)

適用於:SQL Server Azure SQL 受控執行個體

變更資料庫的名稱。

重要

SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。 請改用 ALTER DATABASE MODIFY NAME。 如需詳細資訊,請參閱 ALTER DATABASE

Transact-SQL 語法慣例

語法

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

引數

[ @dbname = ] N'dbname'

資料庫的目前名稱。 @dbname為 sysname,沒有預設值。

[ @newname = ] N'newname'

資料庫的新名稱。 @newname為 sysname,沒有預設值。 @newname必須遵循標識符的規則。

傳回碼值

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

備註

您無法重新命名在作用中異地複寫關聯性中設定的 Azure SQL 資料庫。

權限

需要系統管理員dbcreator 固定伺服器角色中的成員資格。

範例

下列範例會 Accounting 建立資料庫,然後將資料庫的名稱變更為 Financialsys.databases然後會查詢目錄檢視,以確認資料庫的新名稱。

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