下載最新版本
本文會列出 SqlPackage 發行版本所提供的功能與修正。
如何閱讀這些發行說明
每個章節的 「適用」 欄位範圍如下：
-
SqlPackage CLI - 命令列動作（發佈、匯入、匯出、解壓、Parquet、診斷、dotnet 工具）
-
MSBuild / SQL 專案 - SQL 專案建置（
Microsoft.Build.Sql SDK，SQL Server Data Tools （SSDT）整合）
-
DacFx API / 綱目比對 -
Microsoft.SqlServer.DacFx NuGet API，綱目比對
-
平台 - ScriptDom、Microsoft.Data.SqlClient、.NET 支援、系統 DACPAC、相容性預設
目前發行版本（170.x）
以下版本為目前支援的 SqlPackage 版本。
170.3.93 SqlPackage
發行日期： 2026年2月10日
dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Features
| Feature |
Details |
適用對象 |
| Deployment |
新增對資料庫選項 ACCELERATED_DATABASE_RECOVERY 及 OPTIMIZED_LOCKING. 的支援。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Permissions |
強化授權發布以包含 EXECUTE ON EXTERNAL MODEL 權限。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Platform |
新增 .NET 10 支援至 DacFx 函式庫及 SqlPackage CLI。 SqlPackage dotnet tool 同時適用於 .NET 8 與 .NET 10。 |
平台; SqlPackage CLI; DacFx API / 結構比較 |
| Platform |
新增 .NET Standard 2.0 支援至 DacFx 函式庫。 |
平台;DacFx API / 結構比較 |
| Platform |
參考資料 Microsoft.Data.SqlClient v6.1.3。 |
Platform |
| ScriptDom |
已將 ScriptDom 更新至 170.157.0 版本。 |
Platform |
| Vector |
擴充向量欄位支援，允許更改基底類型。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
Fixes
| Feature |
Details |
適用對象 |
| Deployment |
已修正在目標資料庫包含安全政策時，部署到 Microsoft Fabric SQL 資料庫時的錯誤。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Export |
修正了匯出.dacpac檔案時，因布林屬性使用True/False值，而未使用小寫形式的true/false值，導致未通過 XSD 架構驗證的問題。
GitHub 問題 |
SqlPackage CLI |
| Import |
修正了一個問題：當匯入一個名稱中帶有特殊字元（例如 /、 "、 $或 ）的資料表時，資料匯入時會無聲無息地無法匯入資料，且不會提醒使用者。
GitHub 問題 |
SqlPackage CLI |
| Ledger |
修正了一個問題，就是在模型驗證和建置期間，擁有計算欄位的帳本表會引發問題 NullReferenceException 。
GitHub 問題 |
MSBuild / SQL 專案;DacFx API / 架構比較 |
| SQL 專案 |
修正了一個問題：在資料表上建立一個包含內嵌叢集式欄位儲存索引的 SQL 專案時，因語法錯誤而失敗。
GitHub 問題 |
MSBuild / SQL 專案 |
| SQL 專案 |
已修正一個問題，當在包含 NVARCHAR(MAX) 或其他 LOB 類型欄位的表格上使用叢集欄儲索引時，系統錯誤地回報欄儲索引不支援向量欄位。
GitHub 問題 |
MSBuild / SQL 專案 |
| Vector |
修正了一個問題，該問題導致使用工作程序 VECTOR_SEARCH 時，出現驗證警告，提示欄位參考無法解析。
GitHub 問題 |
MSBuild / SQL 專案;DacFx API / 架構比較 |
170.2.70 Sql套件
發布日期： 2025 年 10 月 14 日
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
適用對象 |
| 外部模型 |
新增對 Azure SQL 資料庫與 SQL Server 2025（17.x） 外部模型的支援，用於匯入、匯出、擷取、部署及 SQL 專案建置。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
| 外部模型 |
新增對函數 AI_GENERATE_CHUNKS 和 AI_GENERATE_EMBEDDINGS的支援。 |
SqlPackage CLI;DacFx API / 架構比較 |
| JSON |
新增對 Azure SQL Database 及 SQL Server 2025（17.x） 中 JSON 索引的支援，用於匯入、匯出、擷取、部署及 SQL 專案建置。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
| JSON |
新增對 JSON 函式 JSON_ARRAYAGG、 JSON_OBJECTAGG、 JSON_QUERY及 的支援。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
| Platform |
SqlPackage .zip 建構版的 .NET SDK 已更新至 8.0.414 |
平台;SqlPackage CLI |
| Regex |
新增對該 REGEXP_LIKE 功能的支援。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
| ScriptDom |
已將 ScriptDom 更新至 170.128.0 版。 |
Platform |
| Vector |
新增對 Azure SQL Database 與 SQL Server 2025（17.x）向量索引的支援，用於匯入、匯出、擷取、部署及 SQL 專案建置。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
| Vector |
擴展向量資料型別支援至 SQL Server 2025（17.x），並指定 32 位元浮點大小。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
| Vector |
新增對向量函數 VECTOR_SEARCH的支援。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
Fixes
| Feature |
Details |
適用對象 |
| 資料遮罩 |
修正了專案建置時無法辨識日期時間資料遮蔽函數的問題。
GitHub 問題 |
MSBuild / SQL 專案 |
| 外部模型 |
修正了一個外部模型依賴資料庫範圍憑證導致專案建置失敗的問題。 |
MSBuild / SQL 專案 |
| JSON |
修正將 JSON 索引與預設 JSON 路徑進行比較時的錯誤。 |
DacFx API / 架構比較;SqlPackage CLI |
| Platform |
參考 Microsoft.Data.SqlClient v5.1.7。 |
Platform |
| XML |
修正了一個問題，就是在模型比較時，XML 查詢路徑（xQuery）沒有被視為大小寫敏感。 即使在不區分大小寫的資料庫上，xQuery 路徑也會區分大小寫。
GitHub 問題 |
DacFx API / 架構比較;SqlPackage CLI |
170.1.61 Sql套件
發行日期： 2025年7月30日
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
適用對象 |
| 資料虛擬化 |
新增對 Azure SQL 資料庫 資料虛擬化 物件的支援，涵蓋匯入、匯出、擷取及發佈操作。 |
SqlPackage CLI |
| 資料虛擬化 |
新增了 Azure SQL 資料庫到 publish with parquet files 預覽，允許使用 Azure Blob Storage 和 parquet 檔案將資料匯入資料庫。 Azure SQL 資料庫無法將資料擷取成 parquet 檔案，因為這取決於 Azure SQL 資料庫所沒有的功能。 CREATE EXTERNAL TABLE AS SELECT |
SqlPackage CLI |
| Deployment |
新增對發佈屬性 /p:IgnorePreDeployScript 和 /p:IgnorePostDeployScript的支援。 這些屬性預設為 false ，且啟用時會導致部署計劃省略對應的腳本。
GitHub 問題 |
SqlPackage CLI;DacFx API / 架構比較 |
| Permissions |
新增對 Microsoft Fabric 中 Azure SQL 資料庫及 SQL 資料庫權限 ALTER ANY EXTERNAL MIRROR 的支援。 需要此許可權才能匯出包含一或多個 鏡像數據表的資料庫。
GitHub 問題 |
SqlPackage CLI;DacFx API / 架構比較 |
| Permissions |
為 SQL Server 2025（17.x）新增對CREATE ANY EXTERNAL MODEL 和ALTER ANY EXTERNAL MODEL權限的支援。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Permissions |
新增對 SQL Server 2025（17.x）及 Azure SQL 資料庫權限 ALTER ANY INFORMATION PROTECTION 的支援。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Platform |
SqlPackage .zip 建置版 .NET SDK 已更新至 8.0.412。 |
平台;SqlPackage CLI |
| ScriptDom |
已將 ScriptDom 更新為 170.0.64 版。 |
Platform |
| ScriptDom |
更新 Fabric 平台中的資料倉儲，使之在 ScriptDom 中使用 TSqlFabricDWParser。 |
平台;DacFx API / 結構比較 |
Fixes
| Feature |
Details |
適用對象 |
| 永遠加密 |
修正了發佈Interactive/AzureKeyVaultAuthMethod參數選項無法正常運作的問題。 |
SqlPackage CLI |
| Deployment |
修正了部署中屬性設定錯誤的問題。DbScopedConfigMaxDOPSecondary
GitHub 問題 |
SqlPackage CLI;DacFx API / 架構比較 |
| Deployment |
在 Microsoft Fabric 中，已修正一個問題：由於資料倉儲不支援發佈包含外鍵約束的資料表的語法，導致發佈失敗。 |
SqlPackage CLI |
| Deployment |
修正了在部署到 Microsoft Fabric SQL 資料庫時，伺服器物件被包含的問題。 Microsoft Fabric 的 SQL 資料庫不支援伺服器物件。
GitHub 問題 |
SqlPackage CLI |
| Deployment |
解決了建立叢集欄位索引的問題，方法是先建立叢集索引，這會增加部署負擔和時間。
GitHub 問題 |
SqlPackage CLI |
| Extract |
已修正一個問題：在 Microsoft Fabric 中從 SQL 資料庫擷取資料庫時，使用者定義腳本無法使用。
GitHub 問題 |
SqlPackage CLI |
170.0.94 Sql套件
發佈日期： 4月15， 2025
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
適用對象 |
| DACPACVerify |
支援驗證兩個.dacpac文件內容的功能已添加到預覽工具Microsoft.DacpacVerify中。 |
DacFx API / 架構比較 |
| Extract |
新增支援將 .dacpac 檔案解壓到資料夾。 該 /Action:Extract 命令與 /SourceFile: 和 /TargetFile: 參數一起使用。 目標文件必須是一個資料夾，並且當指定源檔 （）.dacpac 時，任何資料庫連接屬性都無效。 在從.dacpac檔案中提取而非從源資料庫時，屬性/p:ExtractTarget=SchemaObjectType是必需的。 執行檔 Dacunpack.exe 會從安裝程式 DacFx.msi 中移除。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Parquet |
新增對 Time stamp、rowversion、uniqueidentifier、text、ntext、image、json、xml 及向量資料類型的支持，適用於 Azure Blob Storage 中使用 Parquet 檔案並搭配 SqlPackage 擷取與發佈操作。 |
SqlPackage CLI |
| Parquet |
新增支援在資料表包含不支援資料型態時，將資料匯出與匯入至 BCP 檔案，並透過 SqlPackage 擷取與發佈操作使用 Azure Blob 儲存中的 Parquet 檔案處理剩餘資料。 一個範例資料型別是 sql_variant，包含該類型欄位的資料表會寫入 BCP .dacpac ，而其餘資料表則寫入 Azure Blob Storage 中的 Parquet 檔案。 |
SqlPackage CLI |
| Platform |
將 .NET Framework 的 SqlPackage 版本更新為 .NET Framework 4.7.2。 |
平臺;SqlPackage CLI |
| Platform |
刪除了對 .NET 6 的支援。 |
平台;SqlPackage CLI |
| ScriptDom |
將 ScriptDom 更新到版本 170.18.0。 |
Platform |
| SQL 專案 |
Azure SQL 資料庫與 Microsoft Fabric 中 SQL 資料庫的預設相容性等級現設為 170。 有關詳細資訊，請參閱 Azure SQL 資料庫中的資料庫相容性級別 170 和 Microsoft Fabric 中的 SQL 資料庫。 |
MSBuild / SQL 專案 |
| Vector |
目標平台 Azure SQL Database 現在支援向量數據類型進行導入、匯出、提取、部署和 SQL 項目構建。 |
SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較 |
Fixes
| Feature |
Details |
適用對象 |
| Deployment |
修正了一個問題：當對外部資料表進行變更部署時，若修改後的資料表中沒有包含 REJECT_VALUE 或 REJECT_SAMPLE_VALUE 的值，會導致所有外部資料表被丟棄並重新建立。 |
SqlPackage CLI;DacFx API / 架構比較 |
| Deployment |
修正了一個問題：若欄位的彙總方式指定且與資料庫預設的整合相符，則修改欄位以延長其長度會導致錯誤的資料遺失警告。
GitHub 問題 |
SqlPackage CLI;DacFx API / 架構比較 |
| Deployment |
修正了一個問題，因為資料表上的敏感度分類變更會導致索引被重新建立。
GitHub 問題 |
SqlPackage CLI;DacFx API / 架構比較 |
| Export |
優化了出口作業中表格大小估計的使用。 |
SqlPackage CLI |
| Extract |
修正了一個用資料庫引用提取 a .dacpac 失敗的問題。
GitHub 問題 |
SqlPackage CLI;DacFx API / 架構比較 |
| Fabric 資料倉儲 |
修正了在發佈操作中呼叫 sp_refreshsqlmodule 系統儲存程序的問題。 Fabric Data Warehouse 不支援 sp_refreshsqlmodule ，導致部署失敗。 |
SqlPackage CLI |
| Fabric 資料倉儲 |
修正了當從 Fabric Data Warehouse 擷取資料庫時，資料表限制僅包含在 .dacpac 檔案中但未包含在 .sql 檔案中的問題。
GitHub 問題 |
SqlPackage CLI |
| SQL 專案 |
修正了一個在 Visual Studio 未安裝 SSDT 建置會導致錯誤建置行為的問題。
GitHub 問題 |
MSBuild / SQL 專案 |
| SQL 專案 |
修正了啟用程式碼分析時，輸出中重複出現建置警告的問題。
GitHub 問題 |
MSBuild / SQL 專案 |
| SQL 專案 |
修正了將服務 代理 參數設定為變數時出現錯誤警告的問題。
GitHub 問題 |
MSBuild / SQL 專案 |
已存檔的版本（162.x 及更早版本）
你可以在 SqlPackage 的版本說明（存檔）中找到版本 162.x 及更早版本的釋出說明。