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

SqlPackage は Windows、macOS、Linux 上で動作し、dotnet tool を使って、またはスタンドアロンの zip ダウンロードとしてインストールできます。

  • バージョン番号: 162.1.172
  • ビルド番号: 162.1.172.1
  • リリース日: 2024 年 1 月 9 日

最新リリースに関する詳細については、リリース ノートをご覧ください。

Note

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

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

SqlPackage を dotnet ツールとしてインストールするには、.NET SDK がコンピューターにインストールされている必要があります。 SqlPackage をグローバル ツールとしてインストールすると、パス sqlpackage で として使用できるようになります。これは、Windows、macOS、Linux 用に SqlPackage をインストールするための推奨される方法です。 SqlPackage は、.NET 6 および .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

プレビュー リリース

SqlPackage のプレビュー リリースは、dotnet ツール フィードで入手できます。 プレビュー リリースをインストールするには、dotnet tool install コマンドで --version オプションを使います。 たとえば、SqlPackage のバージョン 162.2.82-preview をインストールするには、次のコマンドを実行します。

dotnet tool install -g microsoft.sqlpackage --version 162.2.82-preview

dotnet ツールの update コマンドは、プレビュー リリースに自動更新されません。 プレビュー リリースに更新するには、dotnet tool install コマンドで --version オプションを使用します。 リリースの一覧は、dotnet ツール フィードで入手できます。

インストール、zip ダウンロード (代替)

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

プラットフォーム ダウンロード
Windows .NET 6 zip ファイル
Windows MSI インストーラー
macOS .NET 6 zip ファイル
Linux .NET 6 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 6)

  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\160\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 パッケージ内にあります。 現在の DacFx のバージョンは 162.1.172.1 です。

.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 のバリアントではなく、このパッケージへの参照を新規に作成する必要があります。

Supported Operating Systems

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

Windows (x64)

  • Windows 11
  • Windows 10 (1607+)
  • Windows 8.1
  • Windows 7 SP1
  • Windows サーバー コア
  • Windows Server 2012 R2
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022

macOS

  • macOS 14 "Sonoma"
  • macOS 13 "Ventura"
  • macOS 12 "Monterey"
  • macOS 11 "Big Sur"

Linux (x64)

  • Debian 10、11
  • Red Hat Enterprise Linux 7+
  • SUSE Linux Enterprise Server v12 SP2+
  • Ubuntu 16.04、18.04、20.04、22.04

使用できる言語

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

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

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

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

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

次の手順

Microsoft のプライバシーに関する声明