下載並安裝 SqlPackage
SqlPackage 會在 Windows、macOS 和 Linux 上執行,並可透過 dotnet tool
或獨立 zip 下載安裝。 如需最新版本的詳細資訊,請參閱版本資訊。
- 版本號碼:162.3.566
- 組建編號:162.3.566.1
- 發行日期:2024 年 6 月 24 日
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
將檔案解壓縮並啟動 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
將檔案解壓縮並啟動 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 的位置:
> sqlpackage
Windows (.NET Framework)
此版本的 SqlPackage 包含標準的 Windows 安裝程式體驗,以及 .zip:
- 下載並執行適用於 Windows 的 DacFramework.msi 安裝程式
- 開啟新的 [命令提示字元] 視窗,然後執行 SqlPackage
- SqlPackage 會安裝到
C:\Program Files\Microsoft SQL Server\160\DAC\bin
資料夾中
- SqlPackage 會安裝到
將 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 變體。
支援的作業系統
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 分享意見反應