SQL Server Data Tools，SDK 樣式設計預覽

SQL Server Data Tools (SSDT) 是 Visual Studio 的一組開發工具，著重於建置 SQL Server 資料庫和 Azure SQL 資料庫。 Visual Studio 中的 SDK 樣式 SQL 專案，使新一代 SQL 專案能在 Visual Studio 2022 的 SQL Server Data Tools, SDK-style (preview) 功能中實現。 SQL 專案功能延伸至 CI/CD 管線，可讓您使用 SqlPackage 自動建置和部署資料庫專案。

概觀

原始 SQL 專案格式以 MSBuild (.NET Framework) 為基礎，也是 Visual Studio 中 SQL Server Data Tools 所使用的格式。 SDK 樣式專案格式是以新的 SDK 樣式專案 （Microsoft.Build.Sql） 為基礎，而且是 Visual Studio Code 的 SQL 資料庫專案延伸模組所使用的格式。 Microsoft.Build.Sql 專案 SDK 比原始 SQL 專案有彈性，而且包含新功能：

• .NET 8 支援 (跨平台)
• 用於資料庫參考的 NuGet 套件參考
• 專案中檔案的 .sql 預設通配模式

Visual Studio 2026 不支援 SDK 風格的 SQL 專案，而原始 SQL 專案是該版本 Visual Studio 中唯一可用的 SQL 專案格式。 Visual Studio 2022 是唯一在 SQL Server Data Tools， SDK 風格（預覽） 元件中包含 SDK 風格 SQL 專案的 Visual Studio 版本。

如需 SQL 專案的詳細資訊，請參閱 什麼是 SQL 資料庫專案？。 Microsoft.Build.Sql SDK 可在 GitHub 和 NuGet.org 上取得。

安裝

警告

SDK 樣式的 SQL 專案功能是預覽版，不支援與原始 SQL 專案並排安裝。 建議您在獨立 Visual Studio 執行個體安裝 SDK 樣式的 SQL 專案。

若要在 Visual Studio 2022 安裝 SDK 樣式的 SQL 專案，請遵循下列步驟：

1. 從 Visual Studio 下載頁面下載並安裝 Visual Studio 2022 （17.12 或更新版本）。

2. 在安裝期間，選取 [個別元件]索引標籤並搜尋 “SQL”，找出並選取 "SQL Server Data Tools SDK-style (Preview)"。 選取此項目會自動選取必要的相依性。

3. 在 [個別元件] 索引標籤中搜尋 “.NET SDK”，然後選取 [.NET SDK] 元件。 選取此項目會自動選取必要的相依性，包括支援的 .NET 執行階段。 .NET SDK 元件可支援 Visual Studio 中 Microsoft.Build.Sql SDK 的其他版本，這些版本可透過 NuGet.org 取得。

   

4. 繼續安裝，不選取工作負載或額外功能。

Visual Studio 文件提供修改 Visual Studio 安裝以選取個別元件的額外資訊。

如果 SDK 樣式的 SQL 專案與原始 SQL 專案並存安裝，並且建議安裝 SDK 樣式的 SQL Server Data Tools 做為獨立元件，就會發生非預期的行為。 若要確認哪些元件是 Visual Studio 安裝的一部分，請使用 Visual Studio 中的[說明] 功能表，然後選取[關於 Microsoft Visual Studio]。 有數種方法可用於在單一機器利用多個 Visual Studio 執行個體：

• 安裝不同的 Visual Studio 釋出管道，例如 Visual Studio 2022 和 Visual Studio 2022 預覽版。

• 安裝不同版本的 Visual Studio，例如 Visual Studio Community 和 Visual Studio Enterprise。

• 安裝至特定目錄，將 Visual Studio 執行個體與先前安裝的版本分開。

限制

SQL 專案工具提供 SQL 專案工具之間功能的完整比較。 Visual Studio 中的 SDK 樣式 SQL 專案功能限制如下：

• 不支援與原始 SQL 專案並排安裝

• SQL 專案檔案在 Visual Studio 17.12 Preview 2 中使用副檔名 .sqlprojx，而不是 .sqlproj。 在 Visual Studio 17.12 預覽版 3 和更高版本中，擴充套件是 .sqlproj。

• 不支援 SQLCLR 物件

• 未啟用結構描述比較介面

• 未啟用資料表設計工具介面

• 未啟用資料比較介面

• 未啟用資料庫單元測試

Visual Studio 對 SDK 樣式 SQL 專案支援為預覽版，建議從最新的 Visual Studio 2022 預覽版安裝。 Visual Studio 中的 SQL 專案功能積極開發中，歡迎透過開發人員社群提供意見反應。

轉換現有的專案

Microsoft.Build.Sql SDK 樣式的 SQL 專案，可以從頭開始建立，或從現有的 SQL 專案轉換。 您可以將原始 SQL 專案轉換成 Microsoft.Build.Sql 專案，但建議在轉換之前先建立專案的備份。 若要將現有的 SQL 專案轉換為 SDK 樣式專案，請遵循將 原始 SQL 專案轉換為 SDK 樣式專案 操作指南中的步驟。

相關內容

• 什麼是 SQL Database 專案？
• Visual Studio 2022 預覽版的版本資訊
• Visual Studio Code 中的 SQL 專案