英語で読む

次の方法で共有

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

  • [アーティクル]

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

  • バージョン番号: 162.5.57
  • ビルド番号: 162.5.57.1
  • リリース日: 2024 年 11 月 21 日

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 ツールとしてインストールするには、次のコマンドを実行します。

Bash 
dotnet tool install -g microsoft.sqlpackage

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

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

Bash 
dotnet tool update -g microsoft.sqlpackage

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

Bash 
dotnet tool uninstall -g microsoft.sqlpackage

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

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

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

    Bash 
    dotnet --list-sdks

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

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

    Bash 
    dotnet nuget list source

    nuget.org 一覧にない場合は、次のコマンドを使用して NuGet ソースとして追加します。

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

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

    Bash 
    dotnet tool install -g microsoft.sqlpackage

プレビュー リリース

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

Bash 
dotnet tool install -g --prerelease microsoft.sqlpackage

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

Bash 
dotnet tool update -g --prerelease microsoft.sqlpackage

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

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

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

プラットフォーム ダウンロード
Windows .NET 8 zip ファイル
Windows .msi ファイル
macOS .NET 8 zip ファイル
Linux .NET 8 zip ファイル

Linux

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

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

    Bash 
    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:

    Bash 
    sudo apt-get install libunwind8

    Red Hat:

    Bash 
    yum install libunwind
yum install libicu

    Ubuntu:

    Bash 
    sudo apt-get install libunwind8

macOS

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

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

    Bash 
    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 の実行前:

    Bash 
    sudo spctl --master-disable

    SqlPackage の実行後:

    Bash 
    sudo spctl --master-enable

Windows (.NET 8)

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

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

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

    Windows コマンド プロンプト 
    > 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 パッケージ内にあります。

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

Windows コマンド プロンプト 
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 8 を利用して構築されています。 .NET 8 OS の要件は SqlPackage の最小要件です。その依存関係により追加の要件があります。

Windows (x64)

  • Windows 11
  • Windows 10 (1607+)
  • Windows Server Core 2012 R2 以降
  • Windows Server 2012 R2 以降

macOS

  • macOS 12 "Monterey"+

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:
簡体中国語 | 繁体中国語 | 英語 (米国) | フランス語 | ドイツ語 | イタリア語 | 日本語 | 韓国語 | ポルトガル語 (ブラジル) | ロシア語 | スペイン語

関連コンテンツ