次の方法で共有

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

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

  • バージョン番号: 170.0.94
  • ビルド番号: 170.0.94.3
  • リリース日: 2025 年 4 月 15 日

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

注意

以前は、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

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

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

  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 のリンクです。

プラットフォーム ダウンロード
Windows .NET 8 zip ファイル
ウィンドウズ .msi ファイル
macOS .NET 8 zip ファイル
Linux .NET 8 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

    注意

    依存関係が不足している可能性があります。 ご自身の 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

    注意

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

    SqlPackage の実行前:

    sudo spctl --master-disable

    SqlPackage の実行後:

    sudo spctl --master-enable

Windows (.NET 8)

  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 をインストールした場合は、そのファイルを削除します。

自動化された環境

Sqlpackage の最新バージョンをダウンロードするには、Evergreen のリンクを使用できます。

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

注意

その他の NuGet パッケージは、DacFx 名、 Microsoft.SqlServer.DacFx.x64 、 Microsoft.SqlServer.DacFx.x86で発行されました。 両方のプラットフォームのサポートについては、 Microsoft.SqlServer.DacFx パッケージで説明します。 x64 または x86 のバリアントではなく、このパッケージへの参照を新規に作成する必要があります。

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

SqlPackage は Windows、macOS、Linux 上で実行でき、.NET 8 を利用して構築されています。 .NET 8 OS の要件は SqlPackage の最小要件です。その依存関係により追加の要件があります。

Windows (x64)

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

macOS

  • macOS 12 "モントレー"+

Linux (x64)

  • Debian 11 以降
  • Red Hat Enterprise Linux 8 以降
  • SUSE Linux Enterprise Server v12 SP2+
  • Ubuntu 20.04 以降

使用できる言語

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

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

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

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

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

関連コンテンツ