下載並安裝 SqlPackage

發行項
09/18/2024

SqlPackage 會在 Windows、macOS 和 Linux 上執行，並可透過 dotnet tool 或獨立 zip 下載安裝。如需最新版本的詳細資訊，請參閱版本資訊。

版本號碼：162.4.92
組建編號：162.4.92.3
發行日期：2024 年 9 月 18 日

SqlPackage 是針對 .NET 8 和 .NET Framework 開發和發行的。建議透過簡便的 dotnet tool 方法安裝 .NET 8 SqlPackage 版本，它可跨平台且易於更新，或透過可攜獨立式.zip 下載進行安裝。 .NET 8 SqlPackage 版本受益於 .NET 持續提升的效能和可擴縮性，這是專注於新式應用程式的一部分，與適用於 Windows 的 .NET Framework 維護支援形成鮮明對比。 .NET Framework 版本僅作為 .msi Windows Installer 提供。

注意

先前，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 工具來源取得。若要存取預覽版本，請將 --prerelease 選項與 dotnet tool 命令搭配使用。例如，若要安裝最新預覽版本，請執行下列命令：

dotnet tool install -g --prerelease microsoft.sqlpackage

若要將 SqlPackage 更新為最新預覽版本，請執行下列命令：

dotnet tool update -g --prerelease microsoft.sqlpackage

SqlPackage 的 dotnet 工具來源上提供了預覽版本的清單。

安裝，檔案下載 (替代方案)

SqlPackage 也準備了 Windows、macOS 和 Linux 的獨立下載。無需安裝 .NET，但是，此 .zip 下載中包含的相依項在 SqlPackage 的 dotnet 工具選項中更新得更頻繁。下列連結適用於最新版本的 SqlPackage：

平台	下載
Windows .NET 8	壓縮檔
Windows	.msi 檔案
macOS .NET 8	壓縮檔
Linux .NET 8	壓縮檔

Linux

下載適用於 Linux 的 SqlPackage

將檔案解壓縮並啟動 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

下載適用於 macOS 的 SqlPackage
將檔案解壓縮並啟動 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)

下載適用於 Windows 的 SqlPackage
以滑鼠右鍵按一下 Windows 檔案總管中的檔案，選取 [解壓縮全部...]，然後選取目標目錄來解壓縮檔案
開啟新的終端機視窗，並使用命令前往解壓縮 SqlPackage 的位置：
```
> sqlpackage
```

Windows (.NET Framework)

此版本的 SqlPackage 包含標準的 Windows 安裝程式體驗，以及 .zip：

下載並執行適用於 Windows 的 DacFramework.msi 安裝程式
開啟新的 [命令提示字元] 視窗，然後執行 SqlPackage
- SqlPackage 會安裝到 C:\Program Files\Microsoft SQL Server\160\DAC\bin 資料夾中

將 SqlPackage 解除安裝

如果您使用 Windows 安裝程式安裝 SqlPackage，請使用與刪除任何 Windows 應用程式相同的方式解除安裝。

如果您使用 .zip 或其他封存安裝 SqlPackage，請刪除這些檔案。

自動化環境

Evergreen 連結可用於下載最新的 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 CLI 將 NuGet 套件新增至 .NET 專案：

dotnet add package Microsoft.SqlServer.DacFx

注意

其他 NuGet 套件是以 DacFx 名稱 "Microsoft.SqlServer.DacFx.x64" 與 "Microsoft.SqlServer.DacFx.x86" 發佈的。這兩種平台的支援由 "Microsoft.SqlServer.DacFx" 套件涵蓋。應該對此套件進行新的參考，而不是 x64 或 x86 變體。