專案更名、環境遷移(dev→staging→prod)、修正拼字錯誤、合併資料庫等情境都可能需要重命名 SQL Server 資料庫。SQL Server 不提供直接的 RENAME DATABASE 指令,官方支援的標準方法有兩種:
sp_renamedb / ALTER DATABASE ... MODIFY NAME:僅改邏輯名稱,檔案名稱不變(適用簡單情境)。此法會建立全新資料庫,可同時修改邏輯名稱與實體檔案名稱(.mdf/.ldf),徹底乾淨。
-- 使用 T-SQL(建議,可腳本化、版控)
BACKUP DATABASE [OldDBName]
TO DISK = 'D:\Backup\OldDBName_Full.bak'
WITH FORMAT, INIT, NAME = 'OldDBName-Full Backup', STATS = 10;
-- 或使用 SSMS 圖形介面:
-- 右鍵資料庫 → 工作 → 備份 → 完整 → 磁碟 → 加入路徑 → 確定
RESTORE DATABASE [NewDBName]
FROM DISK = 'D:\Backup\OldDBName_Full.bak'
WITH
MOVE 'OldDBName_Data' TO 'D:\Data\NewDBName.mdf', -- 邏輯資料檔名 → 新實體路徑
MOVE 'OldDBName_Log' TO 'D:\Log\NewDBName_Log.ldf', -- 邏輯記錄檔名 → 新實體路徑
REPLACE, -- 若同名資料庫存在則覆蓋
STATS = 10; -- 顯示進度
關鍵點:MOVE子句中的邏輯檔案名稱(OldDBName_Data、OldDBName_Log)必須正確。可用sp_helpfile或sys.master_files查詢原庫邏輯名稱。
還原後,邏輯檔案名仍保持舊名,易混淆。執行:
USE [NewDBName];
GO
ALTER DATABASE [NewDBName] MODIFY FILE (NAME = 'OldDBName_Data', NEWNAME = 'NewDBName_Data');
ALTER DATABASE [NewDBName] MODIFY FILE (NAME = 'OldDBName_Log', NEWNAME = 'NewDBName_Log');
-- 檢查邏輯名稱
SELECT name, physical_name FROM sys.master_files WHERE database_id = DB_ID('NewDBName');
-- 確認應用程式連線字串已更新,舊庫無連線後
DROP DATABASE [OldDBName];
適用於不需變更實體檔名、資料庫可離線、無複寫/鏡像/Always On 參與的簡單情境。
-- 1. 設定單一使用者模式,強制中斷現有連線
ALTER DATABASE [OldDBName] SET SINGLE_USER WITH ROLLBACK IMMEDIATE;
GO
-- 2. 修改資料庫名稱
ALTER DATABASE [OldDBName] MODIFY NAME = [NewDBName];
GO
-- 3. 恢復多使用者模式
ALTER DATABASE [NewDBName] SET MULTI_USER;
GO
EXEC sp_renamedb 'OldDBName', 'NewDBName';
必須離線操作,步驟較繁瑣,通常不如備份/還原法乾淨:
ALTER DATABASE [NewDBName] SET OFFLINE WITH ROLLBACK IMMEDIATE;.mdf/.ldf 檔案。ALTER DATABASE [NewDBName] MODIFY FILE (NAME = 'NewDBName_Data', FILENAME = '新路徑\NewDBName.mdf');ALTER DATABASE [NewDBName] MODIFY FILE (NAME = 'NewDBName_Log', FILENAME = '新路徑\NewDBName_Log.ldf');ALTER DATABASE [NewDBName] SET ONLINE;重命名不影響擁有者與權限。但若應用程式使用硬編碼資料庫名稱,必須同步更新連線字串、預存程序參考、連結伺服器定義、SSIS 套件、Agent 作業等。
備份/還原法同樣適用,MOVE 子句需包含 FILESTREAM 容器邏輯名稱。
# 使用 dbatools 模組 (Install-Module dbatools)
$src = 'OldDBName'
$dst = 'NewDBName'
$backupPath = 'D:\Backup\'
# 備份
Backup-DbaDatabase -SqlInstance localhost -Database $src -Path $backupPath -Type Full -CompressBackup
# 還原並重命名
Restore-DbaDatabase -SqlInstance localhost -Path "$backupPath\$src.bak" -DatabaseName $dst `
-RelocateFile @{ "$src_Data" = "D:\Data\$dst.mdf"; "$src_Log" = "D:\Log\$dst_Log.ldf" } `
-ReplaceDbNameInFile
# 修改邏輯檔名
Invoke-DbaQuery -SqlInstance localhost -Database $dst -Query "
ALTER DATABASE [$dst] MODIFY FILE (NAME = '$src_Data', NEWNAME = '${dst}_Data');
ALTER DATABASE [$dst] MODIFY FILE (NAME = '$src_Log', NEWNAME = '${dst}_Log');
"
# 驗證後刪除舊庫 (謹慎!)
# Remove-DbaDatabase -SqlInstance localhost -Database $src -Confirm:$false
資料庫重命名看似簡單,實則牽一髮動全身。生產環境首選備份/還原法,同時修改邏輯與實體名稱,乾淨無殘留。配合自動化腳本與完整驗證清單,將風險降至最低。切記:操作前必備份,操作後必驗證。