這很重要
Azure Data Studio 將於 2026 年 2 月 28 日停止運行。 建議您使用 Visual Studio Code。 如需移轉至 Visual Studio Code 的詳細資訊，請流覽 Azure Data Studio 發生什麼事？
本文說明開始使用 SQL 資料庫專案延伸模組的三種方式：
移至「資料庫專案」視圖，或在指令選項板中搜尋「資料庫專案：新增」，以建立新的資料庫專案。
現有的資料庫專案 可以透過 「資料庫專案：在指令選項板中開啟現有的」 來開啟。
使用「資料庫專案：從資料庫建立專案」從指令選項板中，或在「連線」視圖中選取「從資料庫建立專案」，從現有資料庫開始。
建立或開啟 SQL 專案後，您就可以開始使用 SQL 專案進行開發了。 您可以採取的一些動作包括：
- 編輯資料表或其他資料庫物件
- 建置和發佈專案
- 使用結構描述比較來視覺化變更
- 根據資料庫中的變更來更新專案
如需 SQL 專案概念和更多教學課程的深入資訊，請參閱什麼是 SQL 資料庫專案？
建立空白的資料庫專案
在 「資料庫專案」 視圖中，選取 「新增專案 」按鈕，然後在出現的文字輸入中輸入專案名稱。 在出現的「選取資料夾」對話方塊中，選取專案資料夾、 .sqlproj 檔案和其他內容所在的目錄。
空白專案會開啟，並在 「資料庫專案」 視圖中可見以供編輯。
開啟現有專案
在 「資料庫專案 」視圖中，選取「 開啟專案 」按鈕，然後從出現的檔案選擇器開啟現有 .sqlproj 檔案。 現有的專案可以源自 Azure Data Studio、Visual Studio Code 或 Visual Studio SQL Server Data Tools。
現有專案隨即開啟，其內容會顯示在 「資料庫專案」 視圖中以供編輯。
從現有資料庫建立資料庫專案
您可以使用資料庫中的現有物件快速填入 SQL 資料庫專案，而不是從空白專案開始。
在物件總管中
在 「連線」 視圖中，連接至包含要擷取之資料庫的 SQL 實例。 右鍵單擊資料庫，然後從上下文功能表中選擇從 資料庫建立專案 。
資料夾結構設定預設為「 結構描述/物件型別 」，並提供不同的方式來在指令碼輸出時自動組織現有物件。資料夾結構設定的選項包括：
- 檔案：為所有物件建立單一檔案
- 平面：為個別檔案中的所有物件建立單一資料夾
- 物件類型：每個物件類型都會建立資料夾，並將每個物件編寫成檔案指令碼
- 模式：會為每個模式建立資料夾，並將每個物件的指令碼寫入檔案。
- 架構/物件型別：每個架構都會建立資料夾，並在資料夾內針對每個物件型別建立其專屬的資料夾，然後將每個物件編寫成檔案指令碼。
在「資料庫專案」視圖中
在 「專案 」檢視中，選取「 從資料庫匯入專案 」按鈕，然後連線到 SQL 執行個體。 建立連線後，請從清單中選取資料庫 可用資料庫 並設定專案的名稱。
最後，選取擷取的資料夾結構。 新專案已開啟，並包含所選資料庫內容的 SQL 腳本。
進一步行動
建置和發佈
部署資料庫專案是在 SQL 資料庫專案延伸模組中達成，方法是將專案建置成 資料層應用程式檔案 （dacpac） ，並發佈至支援的平臺。 在 「資料庫專案」 視圖中，用滑鼠右鍵按一下專案，然後選取 建置以 建立 dacpac 檔案並驗證 SQL 專案。 當您準備好將專案部署至資料庫時，請再次以滑鼠右鍵按一下專案，然後選取 [發佈] 以將 dacpac 發佈至資料庫。
如需此程式的詳細資訊，請參閱 建立和部署SQL專案的教學課程。
結構描述比較
SQL 資料庫專案延伸模組會與 結構描述比較互動，讓您能夠將專案的內容與 dacpac、現有資料庫或其他專案進行比較。 產生的結構描述比較可用來檢視和套用來源與目標之間的差異。
如需結構描述比較和 SQL 專案的詳細資訊，請參閱 SQL 專案的結構描述比較 一文。
從資料庫更新專案
如果某些變更已在資料庫中進行，但尚未在 SQL 專案中進行，則可以從資料庫的狀態更新 SQL 專案。 此更新是透過從「連線」視圖中資料庫的環境定義功能表中選取 從資料庫更新專案，或從「資料庫專案」視圖中 SQL 專案的環境定義功能表中選取來完成。 將 SQL 專案隨資料庫中的變更保持最新狀態是管理資料庫變更的原始碼控管方法之一。
