萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> 資料庫綜合

SQL Server 資料庫重命名完整操作指南:備份還原法與系統預存程序法

前言:為什麼需要重命名資料庫?

專案更名、環境遷移(dev→staging→prod)、修正拼字錯誤、合併資料庫等情境都可能需要重命名 SQL Server 資料庫。SQL Server 不提供直接的 RENAME DATABASE 指令,官方支援的標準方法有兩種:

  1. 備份/還原法:建立新名稱資料庫,刪除舊庫(最通用、最安全)。
  2. 系統預存程序 sp_renamedb / ALTER DATABASE ... MODIFY NAME:僅改邏輯名稱,檔案名稱不變(適用簡單情境)。

方法一:備份/還原法(推薦生產環境)

此法會建立全新資料庫,可同時修改邏輯名稱與實體檔案名稱(.mdf/.ldf),徹底乾淨。

步驟 1:完整備份原資料庫

-- 使用 T-SQL(建議,可腳本化、版控)
BACKUP DATABASE [OldDBName] 
TO DISK = 'D:\Backup\OldDBName_Full.bak'
WITH FORMAT, INIT, NAME = 'OldDBName-Full Backup', STATS = 10;

-- 或使用 SSMS 圖形介面:
-- 右鍵資料庫 → 工作 → 備份 → 完整 → 磁碟 → 加入路徑 → 確定

步驟 2:還原為新名稱,並指定新實體檔案路徑

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 查詢原庫邏輯名稱。

步驟 3:修改邏輯檔案名稱(可選,但強烈建議)

還原後,邏輯檔案名仍保持舊名,易混淆。執行:

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');

步驟 4:驗證並清理

-- 檢查邏輯名稱
SELECT name, physical_name FROM sys.master_files WHERE database_id = DB_ID('NewDBName');

-- 確認應用程式連線字串已更新,舊庫無連線後
DROP DATABASE [OldDBName];

方法二:ALTER DATABASE MODIFY NAME(僅改邏輯名稱)

適用於不需變更實體檔名、資料庫可離線、無複寫/鏡像/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';

實體檔案重命名(若方法二後需同步檔名)

必須離線操作,步驟較繁瑣,通常不如備份/還原法乾淨:

  1. ALTER DATABASE [NewDBName] SET OFFLINE WITH ROLLBACK IMMEDIATE;
  2. 在作業系統層級重命名 .mdf/.ldf 檔案。
  3. ALTER DATABASE [NewDBName] MODIFY FILE (NAME = 'NewDBName_Data', FILENAME = '新路徑\NewDBName.mdf');
  4. ALTER DATABASE [NewDBName] MODIFY FILE (NAME = 'NewDBName_Log', FILENAME = '新路徑\NewDBName_Log.ldf');
  5. ALTER DATABASE [NewDBName] SET ONLINE;

進階情境處理

資料庫參與複寫/鏡像/Always On 可用性群組

  • 必須先移除相關拓撲,重命名後重新設定。
  • 建議使用備份/還原法建立新庫,重新加入可用性群組。

資料庫擁有者 (dbo) 與授權

重命名不影響擁有者與權限。但若應用程式使用硬編碼資料庫名稱,必須同步更新連線字串、預存程序參考、連結伺服器定義、SSIS 套件、Agent 作業等。

含 FILESTREAM / FileTable / In-Memory OLTP

備份/還原法同樣適用,MOVE 子句需包含 FILESTREAM 容器邏輯名稱。

自動化腳本範本(PowerShell + dbatools)

# 使用 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

檢查清單(執行前/後)

  • [ ] 確認無其他服務依賴舊資料庫名稱(連結伺服器、SSIS、Agent、應用程式設定)。
  • [ ] 備份檔案儲存位置磁碟空間足夠。
  • [ ] 目標資料/記錄檔路徑磁碟空間足夠、權限正確(SQL Server 服務帳戶可讀寫)。
  • [ ] 維護視窗內執行,通知相關人員。
  • [ ] 執行後驗證:邏輯名稱、實體檔名、連線測試、應用程式煙霧測試。
  • [ ] 更新文件、部署腳本、CI/CD 變數、監控規則。

延伸閱讀

資料庫重命名看似簡單,實則牽一髮動全身。生產環境首選備份/還原法,同時修改邏輯與實體名稱,乾淨無殘留。配合自動化腳本與完整驗證清單,將風險降至最低。切記:操作前必備份,操作後必驗證。

copyright © 萬盛學電腦網 all rights reserved