深入掌握 SQL Server 系統存儲過程 sp_rename：重命名物件的完整指南

sp_rename 用於變更當前資料庫中使用者物件 (資料表、資料行、索引、條件約束、預存程序、檢視、觸發器等) 或使用者定義資料類型的名稱。

語法結構

sp_rename 
    [ @objname = ] 'object_name' , 
    [ @newname = ] 'new_name' 
    [ , [ @objtype = ] 'object_type' ]

參數說明

關鍵行為與限制

• 自動連帶重命名：重命名 PRIMARY KEY / UNIQUE 條件約束 → 自動重命名關聯索引；重命名關聯 PK 的索引 → 自動重命名 PK 條件約束
• XML 索引支援：可重命名主要/次要 XML 索引
• 不可重命名：系統物件、系統資料類型、跨資料庫物件
• 預存程序/函數/檢視/觸發器：不建議使用 sp_rename。因不會更新 sys.sql_modules.definition 中的定義內容，導致中繼資料不一致。正確做法：DROP 後重建
• 不自動更新參考：重命名資料表/資料行不會自動修改檢視、觸發器、預存程序、應用程式碼中的引用。需手動同步。重命名前請用 sys.sql_expression_dependencies 檢查相依性

實用範例

' 重命名資料表
EXEC sp_rename 'dbo.OldTable', 'NewTable';

' 重命名資料行
EXEC sp_rename 'dbo.Customers.OldCol', 'NewCol', 'COLUMN';

' 重命名索引
EXEC sp_rename 'dbo.Orders.IX_OldIndex', 'IX_NewIndex', 'INDEX';

' 重命名使用者定義資料類型
EXEC sp_rename 'OldTypeName', 'NewTypeName', 'USERDATATYPE';

最佳實踐清單

1. 執行前備份資料庫或建立快照
2. 使用 sys.sql_expression_dependencies 完整掃描相依物件
3. 同步修改所有參考該物件的程式碼 (預存程序、檢視、觸發器、應用程式)
4. 對於可程式化物件 (Proc/View/Trigger/Function) 採用 DROP + CREATE 模式
5. 重命名後執行 sp_refreshview、sp_refreshsqlmodule 更新中繼資料
6. 在維護時段執行，避免鎖衝突影響線上業務

掌握 sp_rename 的行為邊界，能安全高效完成物件重命名，避免因中繼資料不一致導致的難以排查錯誤。