Sdílet prostřednictvím

Stažení a instalace sqlPackage

  • Článek

SqlPackage běží ve Windows, macOS a Linuxu a je k dispozici k instalaci prostřednictvím dotnet tool nebo jako samostatný soubor ZIP ke stažení. Podrobnosti o nejnovější verzi najdete v poznámkách k verzi.

  • Číslo verze 162.5.57
  • číslo sestavení: 162.5.57.1
  • datum vydání : 21. listopadu 2024

SqlPackage se vyvíjí a vydává pro .NET 8 i .NET Framework. Instalace verze .NET 8 SqlPackage se doporučuje prostřednictvím pohodlné dotnet tool metody, která je určená pro různé platformy a je snadno aktualizovatelná, nebo prostřednictvím samostatně přenosného .zip stažení. Verze SqlPackage platformy .NET 8 využívají průběžného přechodu na výkon a škálovatelnost rozhraní .NET v rámci zaměřit se na moderní aplikace, což je rozdíl oproti podpoře údržby rozhraní .NET Framework pro Windows. Verze rozhraní .NET Framework je k dispozici pouze jako .msi instalační služba systému Windows.

Poznámka

Dříve měl SqlPackage jedinečné číslo verze (19) a číslo buildu (160.x). Od verze 161 odpovídá číslo verze SqlPackage číslo verze DacFx, ke které je přidruženo (např. 162.0.52).

Instalace, multiplatformní

Instalace SqlPackage jako nástroje dotnet vyžaduje, aby na vašem počítači byla nainstalována .NET SDK . Instalace SqlPackage jako globální nástroj ji zpřístupní na vaší cestě jako sqlpackage a je doporučenou metodou instalace SqlPackage pro Windows, macOS a Linux. SqlPackage je k dispozici jako nástroj dotnet pro .NET 8 a novější verze.

Pokud chcete sqlPackage nainstalovat jako globální nástroj .NET, spusťte následující příkaz:

dotnet tool install -g microsoft.sqlpackage

Další informace o možnostech dostupných pomocí příkazu dotnet tool install najdete v dokumentaci k instalaci nástroje dotnet.

Pokud chcete aktualizovat SqlPackage na nejnovější verzi, spusťte následující příkaz:

dotnet tool update -g microsoft.sqlpackage

Pokud chcete sqlPackage odinstalovat, spusťte následující příkaz:

dotnet tool uninstall -g microsoft.sqlpackage

Řešení potíží s instalací

Pokud během instalace narazíte na problémy, postupujte takto:

  1. ujistěte se, že je nainstalovaná sada .NET SDK: Spuštěním následujícího příkazu ověřte, že je na vašem počítači nainstalovaná sada .NET SDK:

    dotnet --list-sdks

    Pokud sada .NET SDK není uvedená, stáhněte ji a nainstalujte ze stránky pro stažení sady .NET SDK.

  2. Ověření konfigurace zdroje NuGet: Ujistěte se, že nuget.org je nakonfigurovaný zdroj NuGet pro dotnet. Seznam nakonfigurovaných zdrojů NuGet spuštěním příkazu:

    dotnet nuget list source

    Pokud nuget.org není uvedený, přidejte ho jako zdroj NuGet pomocí následujícího příkazu:

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

  3. opakování instalace: Po ověření instalace sady .NET SDK a konfigurace zdroje NuGet zkuste sqlPackage nainstalovat znovu pomocí příslušného příkazu:

    dotnet tool install -g microsoft.sqlpackage

Předběžné verze

Verze Preview SqlPackage jsou k dispozici na informačním kanálu nástrojů dotnet. Pokud chcete získat přístup k verzím Preview, použijte možnost --prerelease s příkazem dotnet tool. Pokud například chcete nainstalovat nejnovější verzi Preview, spusťte následující příkaz:

dotnet tool install -g --prerelease microsoft.sqlpackage

Pokud chcete aktualizovat SqlPackage na nejnovější verzi Preview, spusťte následující příkaz:

dotnet tool update -g --prerelease microsoft.sqlpackage

Seznam verzí preview je k dispozici v kanálu nástroje dotnet pro SqlPackage.

Instalace, stažení souboru (alternativa)

SqlPackage je také připravený jako samostatný soubor ke stažení pro Windows, macOS a Linux. Nevyžaduje se žádná instalace rozhraní .NET, ale závislosti zahrnuté v tomto .zip stahování se aktualizují častěji v možnosti nástroje dotnet pro sqlPackage. Následující odkazy jsou určené pro nejnovější verzi SqlPackage:

Platforma Stáhnout
Windows .NET 8 .zip soubor
Windows .msi soubor
macOS .NET 8 .zip soubor
Linux .NET 8 .zip soubor

Linux

  1. Stáhnout SqlPackage pro Linux

  2. Extrahujte soubor a spusťte SqlPackage, otevřete nové okno terminálu a zadejte následující příkazy:

    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

    Poznámka

    Možná chybí závislosti. Pomocí následujících příkazů nainstalujte tyto závislosti v závislosti na vaší verzi Linuxu:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Stažení SqlPackage pro macOS

  2. Extrahujte soubor a spusťte SqlPackage, otevřete nové okno terminálu a zadejte následující příkazy:

    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

    Poznámka

    Nastavení zabezpečení může vyžadovat úpravu spuštění SqlPackage v systému macOS. K interakci s Gatekeeperem z příkazového řádku použijte následující příkazy.

    Před spuštěním balíčku SqlPackage:

    sudo spctl --master-disable

    Po spuštění balíčku SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Stáhnout SqlPackage pro Windows

  2. Extrahujte soubor tak, že kliknete pravým tlačítkem na soubor v Průzkumníku Windows a vyberete Extrahovat vše... a vyberete cílový adresář.

  3. Otevřete nové okno Terminálu a cd do umístění, do kterého se extrahoval SqlPackage:

    > sqlpackage

Windows (.NET Framework)

Toto vydání SqlPackage zahrnuje standardní instalační proces systému Windows a .zip:

  1. Stažení a spuštění instalačního programu DacFramework.msi pro Windows
  2. Otevřete nové okno příkazového řádku a spusťte SqlPackage.
    • SqlPackage se nainstaluje do složky C:\Program Files\Microsoft SQL Server\160\DAC\bin

Odinstalovat SqlPackage

Pokud jste nainstalovali SqlPackage pomocí instalačního programu systému Windows, odinstalujte stejným způsobem, jakým odeberete jakoukoli aplikaci systému Windows.

Pokud jste nainstalovali SqlPackage s .zip nebo jiným archivem, odstraňte soubory.

Automatizovaná prostředí

Odkazy evergreen jsou k dispozici ke stažení nejnovějších verzí sqlpackage:

DacFx

SqlPackage je rozhraní příkazového řádku pro architekturu DacFx, které vystavuje některá veřejná rozhraní API DacFx. DacServices (Microsoft.SqlServer.Dac) je související mechanismus integrace nasazení databáze do kanálu aplikace. Rozhraní API DacServices je k dispozici v balíčku prostřednictvím NuGetu Microsoft.SqlServer.DacFx.

Přidání balíčku NuGet do projektu .NET se provádí prostřednictvím rozhraní příkazového řádku .NET pomocí tohoto příkazu:

dotnet add package Microsoft.SqlServer.DacFx

Poznámka

Další balíčky NuGet byly publikovány pod názvem DacFx, Microsoft.SqlServer.DacFx.x64 a Microsoft.SqlServer.DacFx.x86. Podpora obou platforem je pokryta balíčkem Microsoft.SqlServer.DacFx. V tomto balíčku by se měly vytvořit nové odkazy, nikoli varianty x64 nebo x86.

Podporované operační systémy

SqlPackage běží ve Windows, macOS a Linuxu a je sestavený pomocí .NET 8. Požadavky na operační systém .NET 8 jsou minimální požadavky pro SqlPackage, které mají kvůli závislostem další požadavky.

Windows (x64)

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

macOS

  • macOS 12 "Monterey"+

Linux (x64)

  • Debian 11 nebo novější
  • Red Hat Enterprise Linux 8 a novější
  • SUSE Linux Enterprise Server v12 SP2+
  • Ubuntu 20.04+

Dostupné jazyky

Tuto verzi sqlPackage je možné nainstalovat v následujících jazycích:

SqlPackage .NET 8 Windows:
čínština (zjednodušená) | čínština (tradiční) | angličtina (Spojené státy) | francouzština | němčina | italština | japonština | korejština | portugalština (Brazílie) | ruština | španělština

SqlPackage .NET Framework Windows:
čínština (zjednodušená) | čínština (tradiční) | angličtina (Spojené státy) | francouzština | němčina | italština | japonština | korejština | portugalština (Brazílie) | ruština | španělština

SqlPackage .NET 8 macOS:
čínština (zjednodušená) | čínština (tradiční) | angličtina (Spojené státy) | francouzština | němčina | italština | japonština | korejština | portugalština (Brazílie) | ruština | španělština

SqlPackage .NET 8 Linux:
čínština (zjednodušená) | čínština (tradiční) | angličtina (Spojené státy) | francouzština | němčina | italština | japonština | korejština | portugalština (Brazílie) | ruština | španělština

Související obsah