下載並安裝 SqlPackage

SqlPackage 會在 Windows、macOS 和 Linux 上執行,並可透過 dotnet tool 或獨立 zip 下載安裝。

  • 版本號碼:162.2.111
  • 組建編號:162.2.111.2
  • 發行日期:2024 年 2 月 27 日

如需最新版本的詳細資訊,請參閱版本資訊

注意

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 工具來源取得。 若要存取預覽版本,請將 --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 6 壓縮檔
Windows .msi 檔案
macOS .NET 6 壓縮檔
Linux .NET 6 壓縮檔

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
    

    注意

    您可能缺少相依項。 使用下列命令,根據您的 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
    

    注意

    安全性設定可能需要修改,才能在 macOS 上執行 SqlPackage。 請在命令列中使用下列命令,與 Gatekeeper 進行互動。

    執行 SqlPackage 之前:

    sudo spctl --master-disable
    

    執行 SqlPackage 之後:

    sudo spctl --master-enable
    

Windows (.NET 6)

  1. 下載適用於 Windows 的 SqlPackage

  2. 以滑鼠右鍵按一下 Windows 檔案總管中的檔案,選取 [解壓縮全部...],然後選取目標目錄來解壓縮檔案

  3. 開啟新的終端機視窗,並使用命令前往解壓縮 SqlPackage 的位置:

    > 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,請刪除這些檔案。

自動化環境

Evergreen 連結可用於下載最新的 Sqlpackage 版本:

DacFx

SqlPackage 是 DacFx 架構的命令列介面,可公開一些公用 DacFx API。 DacServices (Microsoft.SqlServer.Dac) 是一個與將資料庫部署整合到應用程式管線相關的機制。 DacServices API 可透過 NuGet (Microsoft.SqlServer.DacFx) 在套件中取得。 目前 DacFx 版本為 162.1.172.1。

使用此命令透過 .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 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 8 Windows:
簡體中文 | 繁體中文 | 英文 (美國) | 法文 | 德文 | 義大利文 | 日文 | 韓文 | 葡萄牙文 (巴西) | 俄文 | 西班牙文

SqlPackage .NET Framework Windows:
簡體中文 | 繁體中文 | 英文 (美國) | 法文 | 德文 | 義大利文 | 日文 | 韓文 | 葡萄牙文 (巴西) | 俄文 | 西班牙文

SqlPackage .NET 8 macOS:
簡體中文 | 繁體中文 | 英文 (美國) | 法文 | 德文 | 義大利文 | 日文 | 韓文 | 葡萄牙文 (巴西) | 俄文 | 西班牙文

SqlPackage .NET 8 Linux:
簡體中文 | 繁體中文 | 英文 (美國) | 法文 | 德文 | 義大利文 | 日文 | 韓文 | 葡萄牙文 (巴西) | 俄文 | 西班牙文

後續步驟

Microsoft 隱私權聲明