共用方式為

SQL Server Data Tools, SDK-style (preview)

  • 發行項

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

概觀

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

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

新的開發工作應考慮使用 SDK 樣式的專案格式，因為這是未來將支援的格式。 SDK 樣式專案具有來自原始 SQL 專案的超集功能，而現有的 SQL 專案可以透過修改專案檔轉換成 SDK 樣式專案。 功能涵蓋範圍的例外狀況是支援 SQLCLR 物件，這些物件需要 .NET Framework，而且在 SDK 樣式專案中不受支援。

SQL 資料庫專案主題就 SQL 專案提供了更多文件，而 GitHub 和 NuGet.org 則提供了 Microsoft.Build.Sql SDK。

安裝

警告

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

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

  1. 從 [Visual Studio 下載頁面] 下載並安裝 Visual Studio 2022 預覽版 (17.12 預覽版 2 或更新版本)。
  2. 在安裝期間，選取 [個別元件] 索引標籤並搜尋 “SQL”，找出並選取 "SQL Server Data Tools SDK-style (Preview)"。 選取此項目會自動選取必要的相依性。
  3. 不選取工作負載或額外功能繼續安裝。

Visual Studio 安裝程式的螢幕擷取畫面，其中 [個別元件] 索引標籤開啟。

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 專案並排安裝
  • 在 Visual Studio 17.12 預覽版 2，SQL 專案檔使用延伸項目 .sqlprojx 而不是 .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 專案操作指南中的步驟。

相關內容