SQL 資料庫專案延伸模組

這很重要

Azure Data Studio 將於 2026 年 2 月 28 日停止運行。 建議您使用 Visual Studio Code。 如需移轉至 Visual Studio Code 的詳細資訊，請流覽 Azure Data Studio 發生什麼事？

SQL 資料庫專案延伸模組是 Visual Studio Code 延伸模組，用於在專案型開發環境中開發 SQL 資料庫。 相容的資料庫包括 SQL Server、Azure SQL 資料庫、Azure SQL 管理實例、Warehouse in Fabric 以及 SQL 資料庫 in Fabric。 SQL 專案是 SQL 物件的本端表示法，這些物件構成單一資料庫的結構描述，例如表格、預存程序或函數。 建置 SQL 資料庫專案時，輸出成品是檔案 .dacpac 。 您可以使用 SQL 資料庫專案延伸模組發佈 SQL 資料庫專案，或使用 SqlPackage 命令列介面發佈.dacpac，以更新新的和現有的資料庫，以符合.dacpac的內容。

如需 SQL 專案概念的詳細資訊，請參閱 什麼是 SQL 資料庫專案？

擴充功能

SQL 資料庫專案延伸模組提供下列功能：

• 建立新的空白 Microsoft.Build.Sql 專案。
• 從連線的資料庫建立新專案。
• 開啟先前在 Visual Studio Code 或 SQL Server Data Tools 中建立的專案。
• 透過在專案中新增或移除物件 （表格、檢視、預存程序） 或自訂指令碼來編輯專案。
• 在資料夾中組織檔案/腳本。
• 將系統資料庫或使用者專屬的 dacpac 新增為參照。
• 建置單一專案。
• 部署單一專案。
• 從部署設定檔載入連線詳細資料 （SQL Windows 驗證） 和 SQLCMD 變數。

Install

您可以在 Visual Studio Code 中安裝 SQL 資料庫專案延伸模組。

SQL 資料庫專案延伸模組會與 Visual Studio Code 的 mssql 延伸模組一起安裝。

依賴

SQL 資料庫專案延伸模組相依於 .NET SDK （必要） 和 AutoRest.Sql （選擇性） 。

.NET SDK

專案建置功能需要 .NET SDK，如果延伸模組無法偵測到支援的版本，系統會提示您安裝 .NET SDK。 .NET SDK 可以下載並安裝適用於 Windows、macOS 和 Linux。

如果您想要 檢查目前安裝 的 dotnet SDK 版本，請開啟終端機並執行下列命令：

dotnet --list-sdks

安裝 .NET SDK 之後，您的環境已準備好使用 SQL 資料庫專案延伸模組。

常見問題

來源清單中缺少 Nuget.org 可能會導致錯誤訊息，例如：

• error MSB4236: The SDK 'Microsoft.Build.Sql/0.1.9-preview' specified could not be found.
• Unable to find package Microsoft.Build.Sql. No packages exist with this id in source(s): Microsoft Visual Studio Offline Packages

若要檢查 nuget.org 是否已註冊為來源，請從命令列執行 dotnet nuget list source ，並檢閱參考 nuget.org 項目的 [Enabled] 結果。如果 nuget.org 未註冊為來源，請執行 dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org。

不支援的 .NET SDK 版本可能會導致錯誤訊息，例如：

• error MSB4018: The "SqlBuildTask" task failed unexpectedly.
• error MSB4018: System.TypeInitializationException: The type initializer for 'SqlSchemaModelStaticState' threw an exception. ---> System.IO.FileNotFoundException: Could not load file or assembly 'System.Runtime, Version=4.2.2.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. The system cannot find the file specified. [c:\Users\ .sqlproj]_ （其中連結的不存在檔案具有不相符的右方括號）。

若要強制 SQL 資料庫專案延伸模組在安裝多個版本時使用 v6.x 版本的 .NET SDK，請將 global.json 檔案新增至包含 SQL 專案的資料夾。

如需疑難排解 SQL 專案建置的詳細資訊，請參閱 疑難排解 SQL 專案建置。

SQLCLR

Visual Studio Code 不支援資料庫專案中的 SQLCLR 物件，因為它們依賴 .NET Framework，而 SQL Database 專案延伸模組會使用 .NET 來建置專案。

工作空間

SQL 資料庫專案包含在 Visual Studio Code 的邏輯工作區 （資料夾） 內。 根據預設，目前工作區中開啟的資料夾內的所有 SQL 專案都可以在 [SQL 資料庫專案] 檢視中使用。

您可以透過「 專案」 窗格中的介面，在工作區中手動新增和移除專案。 如有必要，可以在檔案中 .code-workspace 手動編輯工作區的設定。

在下列範例.code-workspace檔案中，folders陣列會列出 [檔案總管] 窗格中包含的所有資料夾，而其中dataworkspace.excludedProjects的settings陣列會列出 [專案] 窗格中排除的所有 SQL 專案。

{
  "folders": [
    {
      "path": "."
    },
    {
      "name": "WideWorldImportersDW",
      "path": "..\\WideWorldImportersDW"
    }
  ],
  "settings": {
    "dataworkspace.excludedProjects": [
      "AdventureWorksLT.sqlproj"
    ]
  }
}

相關內容

• 什麼是 SQL 資料庫專案？
• 開始使用 SQL 資料庫專案延伸模組
• 取得 SQL Database 專案擴充程式的協助