SqlPackage 的版本資訊

下載最新版本

本文會列出 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.5.96.0 SqlPackage

發行日期: 2026年9月15日

dotnet tool install -g microsoft.sqlpackage --version 170.5.96.0
Platform Download
Windows .NET 10 .zip 檔案
Windows .NET 架構 .msi 檔案
macOS .NET 10 .zip 檔案
Linux .NET 10 .zip 檔案

Features

Feature Details 適用對象
Extract 新增了 DacExtractOptions.PermissionGranteeScope 屬性和 DacPermissionGranteeScope.DatabaseRolesOnly 選項,以僅擷取授與或拒絕給資料庫角色的權限。 預設情況下,擷取操作仍包含所有資料庫主體的權限。 此選項也可作為 SqlPackage 的擷取屬性提供。 SqlPackage CLI;DacFx API / 架構比較
Platform 新增了唯讀 SqlCmdVariablesTargetPlatform 屬性, DacPackage讓呼叫者在部署前能檢查套件的 SQLCMD 變數和目標平台。 DacFx API / 架構比較
結構比對 SchemaComparisonResult 中新增了 IncludeAll()ExcludeAll() 方法,以變更所有可排除之結構描述差異的納入狀態。 DacFx API / 架構比較
SQL 專案 新增 SkipExistingModelValidationTSqlObjectOptions。 此選項允許模型在已有錯誤時繼續進行新增、更新與刪除操作,支援 SQL 專案中的即時 IntelliSense 模型更新。 DacFx API / 架構比較
Vector 新增對向量欄位尺寸及表值參數及函式回傳類型的基本型態的支援。 MSBuild / SQL 專案;DacFx API / 架構比較
ScriptDom 已將 ScriptDom 更新至 180.102.0 版本。 Platform

Fixes

Feature Details 適用對象
程式碼分析 修正了規則 SR0007 錯誤回報 null-safe IS DISTINCT FROMIS NOT DISTINCT FROM 謂詞可空欄警告的問題。 GitHub 問題 MSBuild / SQL 專案
Deployment 修正了 DoNotDropExtendedProperties=True 因為部署選項衝突而未被承認的問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Deployment 修正了 DacFx 在未定義觸發結構時產生不必要的 ALTER TRIGGER 陳述的問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Deployment 修正了一個問題:從專案發布內嵌約束時,會輸出多餘的 ALTER TABLE ... ADD CONSTRAINT 陳述式。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Deployment 修正了部署會為未命名的預設條件產生不正確 DROP 陳述式的問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Deployment 已修正一個問題:@level1type=N'NULL' 在安全性原則上將 sp_addextendedproperty 用於延伸屬性。 SqlPackage CLI;DacFx API / 架構比較
Deployment 修正了一個問題:BACPAC 匯入或部署時,可能會先部署使用 OPENROWSET(BULK ..., DATA_SOURCE = ...) 的預存程序,再部署其外部資料來源。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Deployment 修正了部署預覽報告中沒有顯示欄位重排序後會重新建立的預設限制。 產生的部署腳本已經是正確的。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Export 已修正大型 BACPAC 匯出因 System.IO.Packaging 中發生 Stream was too long 溢位而失敗的問題。 SqlPackage CLI
Export 已修正將大型固定長度 Always Encrypted 欄位匯出至 BACPAC 時的問題。 SqlPackage CLI
Extract 已修正擷取安全性原則中的物件層級權限時發生的 InvalidCastException 問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Extract 已修正 Azure SQL Database 擷取遺失 Microsoft Entra 外部登入或傳統 SQL 登入的使用者對應資料的問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Extract 修正了一個問題:擷取 SQL 專案時,會將每批次 SET ANSI_NULLSSET QUOTED_IDENTIFIER 選項發出到所產生的 .sqlproj 中,因而無法在 Microsoft Fabric 的 Data Warehouse 中部署需要這些選項的物件。 SqlPackage CLI;MSBuild / SQL 專案
Extract 修正了在 SQL Server 2027 中,當存在系統定義的外部語言時,使用 SQL72018: SqlExternalLanguage could not be imported 進行逆向工程會失敗的問題。 SqlPackage CLI;DacFx API / 架構比較
Extract 已修正一個在 Azure SQL 受控執行個體 上逆向工程外部語言失敗的問題,因為is_system_language無法綁定。 SqlPackage CLI;DacFx API / 架構比較
Import 修正了一個問題:當資料表唯一的索引鍵包含 VARBINARY(MAX) 欄位時,BACPAC 匯入會使大型 NULL 值留空。 SqlPackage CLI
Import 修正了含有向量索引的雲端 BACPAC 在資料表資料載入之前匯入失敗的問題。 向量索引的建立現在會在資料階段完成。 SqlPackage CLI
Platform 已修正舊版 DACPAC 在不可搜尋的套件組件串流上進行還原序列化時失敗的問題。 SqlPackage CLI;DacFx API / 架構比較
Platform 修正了 DacPackage.Unpack 允許套件組件路徑解析到要求的目的地目錄之外的問題。 DacFx API / 架構比較
結構比對 修正了一個問題:在將結構描述與 Microsoft Fabric 中的 Data Warehouse 進行比較時,產生的部署指令碼會包含來自已排除資料表的主鍵和其他條件約束。 DacFx API / 架構比較
結構比對 修正了結構描述比較針對可內嵌指令碼的元素產生多餘子元素指令碼的問題。 DacFx API / 架構比較
SQL 專案 修正了透過同義字解析的參考會回報 SQL71558 識別碼大小寫警告的問題。 GitHub 問題 MSBuild / SQL 專案
SQL 專案 修正了一個在建立或更新 SQL 專案時產生非確定性物件排序的問題。 GitHub 問題 MSBuild / SQL 專案
SQL 專案 修正了 SQL 專案建置在參考外部資料時失敗的問題,例如 OPENROWSETGitHub 問題 MSBuild / SQL 專案
SQL 專案 SQL 專案建置中的固定 VECTOR_SEARCH 表別名與距離欄位解析。 MSBuild / SQL 專案;DacFx API / 架構比較
SQL 專案 已將錯誤訊息位置更新為使用 (line,col),而非 (line,col,line,col) MSBuild / SQL 專案

170.4.83.3 SqlPackage

發行日期: 2026年6月3日

dotnet tool install -g microsoft.sqlpackage --version 170.4.83.3
Platform Download
Windows .NET 10 .zip 檔案
Windows .NET 架構 .msi 檔案
macOS .NET 10 .zip 檔案
Linux .NET 10 .zip 檔案

Features

Feature Details 適用對象
資料庫選項 新增支援資料庫選項 AUTOMATIC_INDEX_COMPACTION自動索引壓縮說明文件 SqlPackage CLI;DacFx API / 架構比較
動態資料遮罩 新增對 Microsoft Fabric 中 Data Warehouse 的擷取與發佈操作動態資料遮蔽支援。 SqlPackage CLI;DacFx API / 架構比較
Extract 新增支援將資料庫擷取成 SQL 專案格式。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Platform 參考 Microsoft。Data.SqlClient v6.1.5. Platform
ScriptDom 已將 ScriptDom 更新至 180.18.1 版本。 Platform

Fixes

Feature Details 適用對象
Deployment 已修正因受結構描述繫結的函式阻止 ALTER TABLE 作業而導致的部署失敗。 SqlPackage CLI;DacFx API / 架構比較
Deployment 已修正部署至資料庫時保留外部模型擁有權資訊的問題。 SqlPackage CLI;DacFx API / 架構比較
Deployment 已修正將含有 CLUSTER BY 的資料表部署到 Microsoft Fabric 中的 Data Warehouse 時所發生的問題。 SqlPackage CLI;DacFx API / 架構比較
Deployment 已修正在 Microsoft Fabric 中將帶有IDENTITY欄位的資料表部署到 Data Warehouse 的問題。 SqlPackage CLI;DacFx API / 架構比較
Deployment 已修正部署時 DacPac 檔案以大寫形式搜尋的問題,這可能會在某些地區(如土耳其語)導致部署中斷。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Import 修正了資料庫和 DDL 觸發器插入資料到資料表時,可能會干擾匯入流程的問題。 SqlPackage CLI;DacFx API / 架構比較
結構比對 修正了一個問題:增加 varchar 欄位的長度時,會導致出現資料遺失警告,並且在已有資料列存在時使檢查失敗。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
SQL 專案 修正了在非 Windows 機器上從專案產生 SQL 檔案時的錯誤。 MSBuild / SQL 專案
SQL 專案 修正了使用 .scmp 檔案作為來源的產生腳本包含不想要 SET ANSI_NULLS OFF 指令的問題。 GitHub 問題 MSBuild / SQL 專案;DacFx API / 架構比較
結構比對 修正了在 TargetScripts 檔案中缺少 .scmp 標籤時,例外訊息不正確的問題。 GitHub 問題 DacFx API / 架構比較
Deployment 修正了使用 NullReferenceException 搭配 IncludeCompositeObjects=true 參考時會發生 SameDatabase 的問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較
Platform 在 .NET Core 上指定不支援儲存模型時,已改善錯誤訊息。 GitHub 問題 平台;SqlPackage CLI
Fabric 資料倉儲 修正了將具有 IDENTITY 欄位的資料表部署至 Fabric Data Warehouse 時,因不支援 SEEDINCREMENT 語法而失敗的問題。 GitHub 問題 SqlPackage CLI;DacFx API / 架構比較

170.3.93 SqlPackage

發行日期: 2026年2月10日

dotnet tool install -g microsoft.sqlpackage --version 170.3.93
Platform Download
Windows .NET 10 .zip 檔案
Windows .msi 檔案
macOS .NET 10 .zip 檔案
Linux .NET 10 .zip 檔案

Features

Feature Details 適用對象
Deployment 新增對資料庫選項 ACCELERATED_DATABASE_RECOVERYOPTIMIZED_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 修正了一個問題,就是在模型驗證和建置期間,擁有計算欄位的帳本表會引發問題 NullReferenceExceptionGitHub 問題 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
Platform Download
Windows .NET 8 .zip 檔案
Windows .msi 檔案
macOS .NET 8 .zip 檔案
Linux .NET 8 .zip 檔案

Features

Feature Details 適用對象
外部模型 新增對 Azure SQL 資料庫與 SQL Server 2025(17.x) 外部模型的支援,用於匯入、匯出、擷取、部署及 SQL 專案建置。 SqlPackage CLI;MSBuild / SQL 專案;DacFx API / 架構比較
外部模型 新增對函數 AI_GENERATE_CHUNKSAI_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_ARRAYAGGJSON_OBJECTAGGJSON_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
Platform Download
Windows .NET 8 .zip 檔案
Windows .msi 檔案
macOS .NET 8 .zip 檔案
Linux .NET 8 .zip 檔案

Features

Feature Details 適用對象
資料虛擬化 新增對 Azure SQL 資料庫 資料虛擬化 物件的支援,涵蓋匯入、匯出、擷取及發佈操作。 SqlPackage CLI
資料虛擬化 新增了 Azure SQL 資料庫到 publish with parquet files 預覽,允許使用 Azure Blob 儲存體 和 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 MODELALTER 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
Platform Download
Windows .NET 8 .zip 檔案
Windows .msi 檔案
macOS .NET 8 .zip 檔案
Linux .NET 8 .zip 檔案

Features

Feature Details 適用對象
DACPACVerify 支援驗證兩個.dacpac文件內容的功能已添加到預覽工具Microsoft.DacpacVerify中。 DacFx API / 架構比較
Extract 新增支援將 .dacpac 檔案解壓到資料夾。 該 /Action:Extract 命令與 /SourceFile:/TargetFile: 參數一起使用。 目標文件必須是一個資料夾,並且當指定源檔 ().dacpac 時,任何資料庫連接屬性都無效。 在從/p:ExtractTarget=SchemaObjectType檔案中提取而非從源資料庫時,屬性.dacpac是必需的。 執行檔 Dacunpack.exe 會從安裝程式 DacFx.msi 中移除。 SqlPackage CLI;DacFx API / 架構比較
Parquet 新增對 Time stamp、rowversion、uniqueidentifier、text、ntext、image、json、xml 及向量資料類型的支持,適用於 Azure Blob 儲存體 中使用 Parquet 檔案並搭配 SqlPackage 擷取與發佈操作。 SqlPackage CLI
Parquet 新增支援在資料表包含不支援資料型態時,將資料匯出與匯入至 BCP 檔案,並透過 SqlPackage 擷取與發佈操作使用 Azure Blob 儲存中的 Parquet 檔案處理剩餘資料。 一個範例資料型別是 sql_variant,包含該類型欄位的資料表會寫入 BCP .dacpac ,而其餘資料表則寫入 Azure Blob 儲存體 中的 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_VALUEREJECT_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 及更早版本的釋出說明。