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

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

• バージョン番号: 162.4.92
• ビルド番号: 162.4.92.3
• リリース日: 2024 年 9 月 18 日

SqlPackage は、.NET 8 と .NET Framework の両方向けに開発およびリリースされています。 .NET 8 SqlPackage バージョンのインストールは、クロスプラットフォームで簡単に更新できる便利な dotnet tool 方法、または移植可能な自己完結型の .zip ダウンロードを使用してインストールすることをお勧めします。 .NET 8 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 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 コマンドで --prerelease オプションを使います。 たとえば、最新のプレビュー リリースをインストールするには、次のコマンドを実行します。

dotnet tool install -g --prerelease microsoft.sqlpackage

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

dotnet tool update -g --prerelease microsoft.sqlpackage

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

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

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

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

   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 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\160\DAC\bin フォルダーにインストールされます

SqlPackage をアンインストールする

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

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

自動化された環境

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

• 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

注意

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

次の手順

• SqlPackage について詳しく学習する
• CI/CD パイプラインでの SqlPackage の詳細
• SqlPackage に関する問題のトラブルシューティングの詳細
• DacFx GitHub リポジトリの SqlPackage に関するフィードバックを 共有する

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