Stažení a instalace sqlPackage

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: 170.2.70
• Číslo buildu: 170.2.70.1
• Datum vydání: 14. října 2025

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í neustálého zdokonalování výkonu a škálovatelnosti rozhraní .NET jako součást zaměření na moderní aplikace, což se liší od podpory údržby rozhraní .NET Framework pro Windows. Verze rozhraní .NET Framework je k dispozici pouze jako .msi instalační služba systému Windows.

Note

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říklad 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 . Pokud nainstalujete SqlPackage jako globální nástroj, zpřístupní se na vaší systémové 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

Instalace SqlPackage s .NET 9 nebo novějším

Pokud chcete nainstalovat SqlPackage s novější verzí sady .NET SDK, přidejte --allow-roll-forward do příkazu install:

dotnet tool install -g microsoft.sqlpackage --allow-roll-forward

Tato možnost umožňuje sqlPackage používat novější verzi modulu runtime .NET, pokud není nainstalovaná .NET 8.

Ř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ěřte konfiguraci zdroje NuGet: SqlPackage se publikuje do nuget.orgveřejného informačního kanálu NuGet. Může dojít k chybě, která značí, že microsoft.sqlpackage se nepodařilo najít:

   microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\
   

   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
   

   Tento příkaz by měl zobrazit seznam zdrojů NuGet. Vyhledejte nuget.org ve výstupu, který je obvykle uveden jako https://api.nuget.org/v3/index.json. 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
   

Náhledové verze

Předběžné verze SqlPackage jsou k dispozici v kanálu dotnet tool. 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 instalace rozhraní .NET, ale požadavky na operační systém jsou stejné jako nástroj dotnet install. Závislosti zahrnuté v tomto .zip souboru jsou aktualizovány častěji v nástroji dotnet pro možnost SqlPackage. Následující odkazy jsou určené pro nejnovější verzi SqlPackage:

Platform	Download
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
   

   Note

   Možná vám 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
   

   Note

   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 přejděte do adresáře, do kterého se rozbalil 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\170\DAC\bin

Odinstalujte 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:

• 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 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

Note

Další balíčky NuGet byly publikovány pod názvem Microsoft.SqlServer.DacFx.x64 DacFx a Microsoft.SqlServer.DacFx.x86. Podpora obou platforem se vztahuje na Microsoft.SqlServer.DacFx balíček. 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

• SqlPackage
• SqlPackage v řetězcích vývoje
• řešení potíží s SqlPackage
• Co jsou projekty databáze SQL?
• úložiště DacFx na GitHubu
• prohlášení o zásadách ochrany osobních údajů společnosti Microsoft