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 建立資料庫，然後將資料庫的名稱變更為 Financial。 sys.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

相關內容