HOW TO:重新命名資料庫物件

本主題說明如何在 Visual Studio Premium 中重新命名「資料庫物件」(Database Object)。 當您重新命名資料庫物件時,系統會自動使用新的名稱來更新參考已重新命名物件的其他物件。 例如,當您為資料表中的資料行重新命名時,如果有任何預存程序參考該資料行,則會以新的名稱來自動更新此預存程序。 如需詳細資訊,請參閱重新命名資料庫物件的所有參考

若要重新命名資料庫物件

  1. 在 [結構描述檢視] 中,按一下要重新命名的物件。 例如,若要重新命名資料行,請依序展開 [資料表] 子資料夾、資料表、[資料行] 資料夾,然後按一下要重新命名的物件。

    注意事項注意事項

    在 Visual Studio Premium 中,請使用 [結構描述檢視] 視窗來重構資料庫物件。 您無法從程式碼視窗重構資料庫物件。

  2. 指向 [資料] 功能表上的 [重構],然後按一下 [重新命名]。 您也可用滑鼠右鍵按一下 [結構描述檢視] 中的物件,指向 [重構],然後按一下 [重新命名]。

    [重新命名] 對話方塊隨即出現。

    注意事項注意事項

    如果您嘗試重新命名的資料庫物件包含建置錯誤,就無法重新命名。 在這種情況下,功能表選項會無法使用。

  3. 在 [新名稱] 中,輸入物件的新名稱。

  4. (選擇項) 選取 [預覽變更] 核取方塊。

    注意事項注意事項

    如需如何在執行前預覽變更的詳細資訊,請參閱下面的程序。 根據預設,單元測試和指令碼中的參考不會自動更新。 您必須使用 [預覽變更] 對話方塊來套用這些變更。

  5. (選擇項) 選取 [未限定指令碼和單元測試參考採用預設專案結構描述 dbo] 核取方塊。

    如果清除核取方塊,而您未在指令碼和單元測試中指定完整名稱,就會找不到這些參考。 如果選取核取方塊,而您未在指令碼和單元測試中指定完整名稱,則系統會假設這些物件的預設「結構描述」(Schema) 與專案的預設結構描述相同。

  6. (選擇性) 選取 [更新含有警告或錯誤的結構描述物件中的參考] 核取方塊。

    如果清除核取方塊,重構作業將不包含其定義產生警告或錯誤之物件內的參考。 如果選取核取方塊,即使包含的物件定義含有警告或錯誤,也會更新所有參考。

    注意事項注意事項

    如果在專案包含建置錯誤時重新命名資料庫物件,物件仍能正確重新命名。 不過,該物件的參考則不一定都能正確更新。 如果專案包含建置錯誤,物件會重新命名,而且會盡可能更新參考。 您也可以先修正建置錯誤,然後再執行重新命名作業。 如需詳細資訊,請參閱重新命名資料庫物件前的考量

  7. 按一下 [確定]。

    如果前面選取了 [預覽變更] 核取方塊,[預覽變更] 對話方塊隨即出現。 否則就會直接執行變更。 物件名稱會更新,而新的名稱將出現在 [結構描述檢視] 中。

    注意事項注意事項

    您可以復原變更。 如需詳細資訊,請參閱 HOW TO:復原資料庫重構作業

    除了步驟 6 中所述的選擇性記錄檔以外,每當您將資料庫物件移至不同的結構描述時,系統就會將一些項目寫入 ProjectName.refactorlog 檔案。 這個檔案是資料庫專案的一部分,而且當您部署資料庫專案時會使用到它。 您必須將檔案簽入版本控制並管理檔案,如同您對任何其他共用的專案資產一樣。 如需詳細資訊,請參閱將資料庫物件移至其他結構描述

若要在執行前預覽變更

  1. 在 [重新命名] 對話方塊中,輸入物件的新名稱。

  2. 選取 [預覽變更] 核取方塊,然後按一下 [確定]。

    [預覽變更] 對話方塊隨即出現,其中包含上方窗格和下方窗格。 上方窗格包含了一個樹狀目錄,其中列出將會變更的物件;下方窗格則會顯示為了進行變更所要產生的指令碼。 上方窗格會顯示舊的名稱,而下方窗格則會顯示新的名稱。

  3. 在上方窗格中,展開 [結構描述物件]。

    代表要重新命名的結構描述物件 (或包含該物件的物件) 的 .sql 節點隨即出現,而且也會顯示其他 .sql 節點,代表參考重新命名物件的任何結構描述物件。

  4. 按一下任何一個 .sql 節點。

    下方窗格會顯示 Transact-SQL 程式碼並反白顯示新名稱。

  5. 按一下 [套用]。

    隨即進行變更。 物件名稱會更新,您可以在 [結構描述檢視] 中看到新的名稱。

    注意事項注意事項

    您可以復原變更。 如需詳細資訊,請參閱 HOW TO:復原資料庫重構作業

請參閱

工作

逐步解說:套用資料庫重構技術

HOW TO:將重構變更部署至資料庫

概念

重新命名資料庫物件的所有參考