SqlPackage をダウンロードしてインストールする

SqlPackage は Windows、macOS、Linux 上で動作し、dotnet tool を使って、またはスタンドアロンの zip ダウンロードとしてインストールできます。 最新リリースに関する詳細については、リリース ノートをご覧ください。

• バージョン番号: 170.3.93
• ビルド番号: 170.3.93.6
• リリース日: 2026 年 2 月 10 日

SqlPackage は、.NET と .NET Framework の両方向けに開発およびリリースされています。 .NET 10 SqlPackage バージョンのインストールは、クロスプラットフォームで簡単に更新できる 便利な dotnet tool 方法、または 移植可能な自己完結型の .zip ダウンロードを使用してインストールすることをお勧めします。 .NET 10 SqlPackage リリースでは、.NET Framework for Windows のメンテナンス サポートとは対照的に、 最新のアプリケーションに焦点を当てる一環として、.NET のパフォーマンスとスケーラビリティが継続的に向上するメリットがあります。 .NET Framework のバージョンは、.msi Windows インストーラーとしてのみ使用できます。

Note

以前は、SqlPackage には個別のバージョン番号 (19) とビルド番号 (160.x) がありました。 バージョン 161 以降、SqlPackage のバージョン番号は、関連付けられている DacFx のバージョン番号 (162.0.52 など) と一致します。

インストール、クロスプラットフォーム

SqlPackage を dotnet ツールとしてインストールするには、.NET SDK がコンピューターにインストールされている必要があります。 SqlPackage をグローバル ツールとしてインストールすると、パス sqlpackage で として使用できるようになります。これは、Windows、macOS、Linux 用に SqlPackage をインストールするための推奨される方法です。 SqlPackage は、.NET 8 以降のバージョンの dotnet ツールとして使用できます。

SqlPackage をグローバル .NET ツールとしてインストールするには、次のコマンドを実行します。

dotnet tool install -g microsoft.sqlpackage

dotnet tool install コマンドで使用できるオプションについて詳しくは、dotnet ツールのインストールに関するドキュメントをご覧ください。

SqlPackage を最新バージョンに更新するには、次のコマンドを実行します。

dotnet tool update -g microsoft.sqlpackage

SqlPackage をアンインストールするには、次のコマンドを実行します。

dotnet tool uninstall -g microsoft.sqlpackage

.NET の今後のリリースで SqlPackage をインストールする

新しいバージョンの .NET SDK で SqlPackage をインストールするには、install コマンドに --allow-roll-forward を追加します。

dotnet tool install -g microsoft.sqlpackage --allow-roll-forward

このオプションを使用すると、.NET 8 または .NET 10 がインストールされていない場合に、SqlPackage で新しいバージョンの .NET ランタイムを使用できます。

インストールのトラブルシューティング

インストール中に問題が発生した場合は、次の手順に従います。

1. .NET SDK がインストールされていることを確認します。次のコマンドを実行して、.NET SDK がコンピューターにインストールされていることを確認します。

   dotnet --list-sdks
   

   .NET SDK が一覧にない場合は、.NET SDK のダウンロード ページからダウンロードしてインストール。

2. NuGet ソース構成を確認する: SqlPackage がパブリック NuGet フィードである nuget.orgに発行されます。 microsoft.sqlpackageが見つからないことを示すエラーが発生する場合があります。

   microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\
   

   nuget.orgが dotnet 用に構成された NuGet ソースであることを確認します。 次を実行して、構成済みの NuGet ソースを一覧表示します。

   dotnet nuget list source
   

   このコマンドでは、NuGet ソースの一覧が表示されます。 出力で nuget.org を探します。これは通常、 https://api.nuget.org/v3/index.jsonとして一覧表示されます。 nuget.org 一覧にない場合は、次のコマンドを使用して NuGet ソースとして追加します。

   dotnet nuget add source https://api.nuget.org/v3/index.json
   

3. インストールの再試行: .NET SDK のインストールと NuGet ソースの構成を確認した後、適切なコマンドを使用して SqlPackage のインストールを再試行します。

   dotnet tool install -g microsoft.sqlpackage
   

プレビュー リリース

SqlPackage のプレビュー リリースは、dotnet ツール フィードで入手できます。 プレビュー リリースをアクセスするには、--prerelease コマンドで dotnet tool オプションを使います。 たとえば、最新のプレビュー リリースをインストールするには、次のコマンドを実行します。

dotnet tool install -g --prerelease microsoft.sqlpackage

SqlPackage を最新のプレビュー バージョンに更新するには、次のコマンドを実行します。

dotnet tool update -g --prerelease microsoft.sqlpackage

プレビュー リリースのリストは、SqlPackage のドットネット ツール フィードで入手できます。

インストール、ファイルのダウンロード (代替)

SqlPackage は、Windows、macOS、Linux 用の自己完結型のダウンロードとしても用意されています。 .NET のインストールは必要ありませんが、オペレーティング システムの要件 は、dotnet ツールのインストールと同じです。 この .zip ダウンロードに含まれる依存関係は、SqlPackage のdotnet ツール オプションでより頻繁に更新されます。 以下は、最新バージョンの SqlPackage のリンクです。

Platform	Download
Windows .NET 10	.zip ファイル
Windows	.msi ファイル
macOS .NET 10	.zip ファイル
Linux .NET 10	.zip ファイル

Linux

1. Linux 用の SqlPackage をダウンロードします。

2. ファイルを抽出し、SqlPackage を起動します。 新しいターミナル ウィンドウを開き、次のコマンドを入力します。

   cd ~
   mkdir sqlpackage
   unzip ~/Downloads/sqlpackage-linux-<version string>.zip -d ~/sqlpackage
   echo "export PATH=\"\$PATH:$HOME/sqlpackage\"" >> ~/.bashrc
   chmod a+x ~/sqlpackage/sqlpackage
   source ~/.bashrc
   sqlpackage
   

   Note

   依存関係が不足している可能性があります。 ご自身の Linux のバージョンに応じて、次のコマンドを使ってこれらの依存関係をインストールします。

   Debian:

   sudo apt-get install libunwind8
   

   Red Hat:

   yum install libunwind
   yum install libicu
   

   Ubuntu:

   sudo apt-get install libunwind8
   

macOS

1. macOS 用の SqlPackage をダウンロードします。

2. ファイルを抽出し、SqlPackage を起動します。 新しいターミナル ウィンドウを開き、次のコマンドを入力します。

   mkdir sqlpackage
   unzip ~/Downloads/sqlpackage-osx-<version string>.zip -d ~/sqlpackage
   chmod +x ~/sqlpackage/sqlpackage
   echo 'export PATH="$PATH:~/sqlpackage"' >> ~/.bash_profile
   source ~/.bash_profile
   sqlpackage
   

   Note

   macOS で SqlPackage を実行するには、セキュリティ設定の変更が必要になる場合があります。 コマンド ラインから Gatekeeper を操作するために次のコマンドを実行してください。

   SqlPackage の実行前:

   sudo spctl --master-disable
   

   SqlPackage の実行後:

   sudo spctl --master-enable
   

Windows (.NET 10)

1. Windows 用の SqlPackage をダウンロードします。

2. ファイルを抽出するには、Windows Explorer でファイルを右クリックして [すべて展開...] を選択し、ターゲット ディレクトリを選択します。

3. 新しいターミナル ウィンドウを開き、SqlPackage が抽出された場所へ cd を実行します。

   > sqlpackage
   

Windows (.NET Framework)

このリリースの SqlPackage には、標準の Windows インストーラーのエクスペリエンスと、.zip が含まれています。

1. Windows 用の DacFramework.msi インストーラーをダウンロードして実行します。
2. 新しいコマンド プロンプト ウィンドウを開き、SqlPackage を実行します。
   • SqlPackage は C:\Program Files\Microsoft SQL Server\170\DAC\bin フォルダーにインストールされます

SqlPackage のアンインストール

Windows インストーラーを使って SqlPackage をインストールした場合は、Windows アプリケーションを削除するのと同じ方法でアンインストールします。

.zip やその他のアーカイブを使って SqlPackage をインストールした場合は、そのファイルを削除します。

自動化された環境

インストールと更新が容易なため、CI/CD パイプラインなどの自動化された環境では、dotnet ツール バージョンの SqlPackage をインストールすることをお勧めします。 ただし、ファイルのダウンロード オプションは、自動化された環境でも使用できます。

dotnet tool install -g microsoft.sqlpackage

最新の SqlPackage バージョンをダウンロードする場合は、エバーグリーン リンクを使用できます。

• Linux (https://aka.ms/sqlpackage-linux)
• macOS (https://aka.ms/sqlpackage-macos)
• Windows (https://aka.ms/sqlpackage-windows)
• Windows、.NET Framework (https://aka.ms/dacfx-msi)

DacFx

SqlPackage は DacFx フレームワークのコマンドライン インターフェイスであり、一部のパブリック DacFx API が公開されます。 DacServices (Microsoft.SqlServer.Dac) は、データベースの配置をアプリケーション パイプラインに統合するための関連メカニズムです。 DacServices API は、NuGet の Microsoft.SqlServer.DACFx パッケージ内にあります。

.NET プロジェクトへの NuGet パッケージの追加は、.NET CLI で次のコマンドを使って行います。

dotnet add package Microsoft.SqlServer.DacFx

サポートされるオペレーティング システム

SqlPackage は Windows、macOS、Linux で実行され、.NET 10 を使用してビルドされます。 .NET 10 OS の要件は SqlPackage の最小要件であり、依存関係のために追加の要件があります。

Windows (x64)

• ウィンドウズ11
• Windows 10 (1607 以降)
• Windows Server Core 2012 R2 以降
• Windows Server 2012 R2 以降

macOS

• macOS 14 "Sonoma"+

Linux (x64)

• Debian 12 以降
• Red Hat Enterprise Linux 8 以降
• SUSE Linux Enterprise Server 15 SP6 以降
• Ubuntu 22.04 以降

使用可能な言語

SqlPackage の今回のリリースは、次の言語でインストールできます。

SqlPackage .NET 10 Windows:
簡体中国語 | 繁体中国語 | 英語 (米国) | フランス語 | ドイツ語 | イタリア語 | 日本語 | 韓国語 | ポルトガル語 (ブラジル) | ロシア語 | スペイン語

SqlPackage .NET Framework Windows:
簡体中国語 | 繁体中国語 | 英語 (米国) | フランス語 | ドイツ語 | イタリア語 | 日本語 | 韓国語 | ポルトガル語 (ブラジル) | ロシア語 | スペイン語

SqlPackage .NET 10 macOS:
簡体中国語 | 繁体中国語 | 英語 (米国) | フランス語 | ドイツ語 | イタリア語 | 日本語 | 韓国語 | ポルトガル語 (ブラジル) | ロシア語 | スペイン語

SqlPackage .NET 10 Linux:
簡体中国語 | 繁体中国語 | 英語 (米国) | フランス語 | ドイツ語 | イタリア語 | 日本語 | 韓国語 | ポルトガル語 (ブラジル) | ロシア語 | スペイン語

関連コンテンツ

• SqlPackage
• 開発パイプラインの SqlPackage
• SqlPackage に関する問題のトラブルシューティング
• SQL データベース プロジェクトとは
• DacFx GitHub リポジトリ
• Microsoft のプライバシーに関する声明