最新バージョンをダウンロードする
この記事では、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.4.83.3 SqlPackage
リリース日: 2026 年 6 月 3 日
dotnet tool install -g microsoft.sqlpackage --version 170.4.83.3
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 |
Microsoft FabricのData WarehouseにCLUSTER BYを含むテーブルをデプロイする際の問題を修正しました。 |
SqlPackage CLI;DacFx API/ スキーマの比較 |
| Deployment |
IDENTITY列を持つテーブルをMicrosoft Fabricの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 |
| ファブリック データ ウェアハウス |
サポートされていないIDENTITYまたはSEED構文により、INCREMENT列を含むテーブルをFabric Data Warehouseに配置できない問題を修正しました。
GitHub の問題 |
SqlPackage CLI;DacFx API/ スキーマの比較 |
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 |
DacFx ライブラリと SqlPackage CLI に .NET 10 のサポートを追加しました。 SqlPackage dotnet tool は、.NET 8 と .NET 10 の両方で使用できます。 |
プラットフォーム;SqlPackage CLI;DacFx API/ スキーマの比較 |
| Platform |
DacFx ライブラリに .NET Standard 2.0 のサポートを追加しました。 |
プラットフォーム;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 SqlPackage
リリース日: 2025 年 10 月 14 日
dotnet tool install -g microsoft.sqlpackage --version 170.2.70
Features
| Feature |
Details |
対象 |
| 外部モデル |
インポート、エクスポート、抽出、デプロイ、および SQL プロジェクトビルド用の Azure SQL Database および SQL Server 2025 (17.x) の外部モデルのサポートを追加しました。 |
SqlPackage CLI;MSBuild/SQL プロジェクト;DacFx API/ スキーマの比較 |
| 外部モデル |
関数の AI_GENERATE_CHUNKS と AI_GENERATE_EMBEDDINGSのサポートを追加しました。 |
SqlPackage CLI;DacFx API/ スキーマの比較 |
| JSON |
インポート、エクスポート、抽出、デプロイ、および SQL プロジェクトビルドのための Azure SQL Database および SQL Server 2025 (17.x) の JSON インデックスのサポートを追加しました。 |
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 |
インポート、エクスポート、抽出、デプロイ、および SQL プロジェクトビルド用の Azure SQL Database および SQL Server 2025 (17.x) のベクター インデックスのサポートが追加されました。 |
SqlPackage CLI;MSBuild/SQL プロジェクト;DacFx API/ スキーマの比較 |
| Vector |
ベクター データ型のサポートを SQL Server 2025 (17.x) に拡張し、32 ビット浮動小数点サイズを指定します。 |
SqlPackage CLI;MSBuild/SQL プロジェクト;DacFx API/ スキーマの比較 |
| Vector |
Vector 関数の VECTOR_SEARCHのサポートが追加されました。 |
SqlPackage CLI;MSBuild/SQL プロジェクト;DacFx API/ スキーマの比較 |
Fixes
| Feature |
Details |
対象 |
| データマスキング |
プロジェクトのビルド中に datetime データ マスク関数が認識されない問題を修正しました。
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 SqlPackage
リリース日: 2025 年 7 月 30 日
dotnet tool install -g microsoft.sqlpackage --version 170.1.61
Features
| Feature |
Details |
対象 |
| データ仮想化 |
インポート、エクスポート、抽出、および発行操作での Azure SQL Database の データ仮想化 に関連するオブジェクトのサポートを追加しました。 |
SqlPackage CLI |
| データ仮想化 |
Parquet ファイル プレビューを使用して Azure SQL Database を発行に追加し、Azure Blob Storage と Parquet ファイルを使用してデータをデータベースにインポートできるようにしました。 Parquet ファイルへのデータの抽出は、Azure SQL Database で使用できない機能に依存するため、 Azure SQL Database では使用できません。 CREATE EXTERNAL TABLE AS SELECT。 |
SqlPackage CLI |
| Deployment |
発行プロパティの /p:IgnorePreDeployScript と /p:IgnorePostDeployScriptのサポートが追加されました。 これらのプロパティは既定で false され、有効にすると、対応するスクリプトが省略された展開計画になります。
GitHub の問題 |
SqlPackage CLI;DacFx API/ スキーマの比較 |
| Permissions |
Microsoft Fabric に Azure SQL Database と SQL Database の権限 ALTER ANY EXTERNAL MIRROR のサポートを追加しました。 この権限は、1 つ以上の ミラー化されたテーブルを含むデータベースをエクスポートするために必要です。
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 Database のアクセス許可 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 |
ScriptDom の TSqlFabricDWParser を使用するように、Fabric プラットフォームのデータ ウェアハウスを更新します。 |
プラットフォーム;DacFx API/ スキーマの比較 |
Fixes
| Feature |
Details |
対象 |
| 常に暗号化されています |
Interactive発行パラメーターの/AzureKeyVaultAuthMethod オプションが正しく動作しない問題を修正しました。 |
SqlPackage CLI |
| Deployment |
展開で DbScopedConfigMaxDOPSecondaryproperty が正しく設定されない問題を修正しました。
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 SqlPackage
リリース日: 2025 年 4 月 15 日
dotnet tool install -g microsoft.sqlpackage --version 170.0.94
Features
| Feature |
Details |
対象 |
| DACPACVerify |
2 つの .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 |
SqlPackage の抽出および発行操作で Azure Blob Storage で Parquet ファイルを使用する場合の、データ型のタイムスタンプ、rowversion、uniqueidentifier、text、ntext、image、json、xml、ベクターのサポートが追加されました。 |
SqlPackage CLI |
| Parquet |
SqlPackage の抽出および発行操作で残りのデータに対して Azure Blob Storage の Parquet ファイルを使用しているときに、テーブルにサポートされていないデータ型が含まれている場合に、BCP ファイルへのテーブル データのエクスポートとインポートのサポートを追加しました。 データ型の例が sql_variantされ、その型の列を含むテーブルが .dacpac の BCP に書き込まれ、残りのテーブルは 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 プロジェクト |
Microsoft Fabric の Azure SQL Database と SQL Database の既定の互換性レベルが 170 に設定されました。 詳細については、 Azure SQL Database のデータベース互換性レベル 170 と Microsoft Fabric の SQL データベースに関するページを参照してください。 |
MSBuild/ SQL プロジェクト |
| Vector |
インポート、エクスポート、抽出、デプロイ、および SQL プロジェクトビルド用のターゲット プラットフォーム Azure SQL Database で、ベクター データ型がサポートされるようになりました。 |
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 |
データベース参照を使用して .dacpac を抽出できない問題を修正しました。
GitHub の問題 |
SqlPackage CLI;DacFx API/ スキーマの比較 |
| ファブリック データ ウェアハウス |
sp_refreshsqlmodule システム ストアド プロシージャが発行操作中に呼び出される問題を修正しました。 Fabric Data Warehouse は sp_refreshsqlmodule をサポートしていないため、デプロイが失敗します。 |
SqlPackage CLI |
| ファブリック データ ウェアハウス |
テーブル制約が .dacpac に含まれるが、Fabric Data Warehouse からデータベースが抽出されたときに .sql ファイルに含まれない問題を修正しました。
GitHub の問題 |
SqlPackage CLI |
| SQL プロジェクト |
Visual Studio に SSDT をインストールせずにビルドすると、ビルド動作が正しくない問題を修正しました。
GitHub の問題 |
MSBuild/ SQL プロジェクト |
| SQL プロジェクト |
コード分析が有効になっていると、出力でビルド警告が重複する問題を修正しました。
GitHub の問題 |
MSBuild/ SQL プロジェクト |
| SQL プロジェクト |
Service Broker パラメーターが変数に設定されると、誤った警告が発生する問題を修正しました。
GitHub の問題 |
MSBuild/ SQL プロジェクト |
アーカイブ済みリリース (162.x 以前のバージョン)
バージョン 162.x 以前のバージョンのリリース ノートは、 SqlPackage のリリース ノート (アーカイブ) にあります。