Pobieranie i instalowanie pakietu SqlPackage

Pakiet SqlPackage działa w systemach Windows, macOS i Linux i jest dostępny do zainstalowania za pośrednictwem dotnet tool lub jako samodzielny plik zip. Aby uzyskać szczegółowe informacje o najnowszej wersji, zobacz informacje o wersji.

Numer wersji: 170.3.93
Numer kompilacji: 170.3.93.6
Data wydania: 10 lutego 2026 r.

Pakiet SqlPackage został opracowany i wydany zarówno dla platform .NET, jak i .NET Framework. Zainstalowanie wersji .NET 10 SqlPackage jest zalecane za pomocą wygodnej dotnet tool metody, która jest międzyplatformowa i łatwa do zaktualizowania lub za pośrednictwem przenośnego samodzielnego pobierania .zip. Wersje programu .NET 10 SqlPackage korzystają z ciągłych postępów w zakresie wydajności i skalowalności platformy .NET w ramach skupienia się na nowoczesnych aplikacjach, co kontrastuje z obsługą konserwacji programu .NET Framework dla systemu Windows. Wersja programu .NET Framework jest dostępna tylko jako instalator.msi Windows.

Note

Wcześniej pakiet SqlPackage miał odrębny numer wersji (19) i numer kompilacji (160.x). Począwszy od wersji 161, numer wersji pakietu SqlPackage jest zgodny z numerem wersji DacFx, z który jest skojarzony (na przykład 162.0.52).

Instalacja, międzyplatformowa

Zainstalowanie pakietu SqlPackage jako narzędzia dotnet wymaga zainstalowania zestawu SDK platformy .NET na maszynie. Zainstalowanie SqlPackage jako narzędzia globalnego udostępnia je w systemowej ścieżce jako sqlpackage i jest zalecaną metodą instalowania SqlPackage dla systemów Windows, macOS i Linux. Pakiet SqlPackage jest dostępny jako narzędzie dotnet dla platformy .NET 8 i nowszych wersji.

Aby zainstalować pakiet SqlPackage jako globalne narzędzie .NET, uruchom następujące polecenie:

dotnet tool install -g microsoft.sqlpackage

Więcej informacji na temat opcji dostępnych za dotnet tool install pomocą polecenia można znaleźć w dokumentacji instalacji narzędzia dotnet.

Aby zaktualizować pakiet SqlPackage do najnowszej wersji, uruchom następujące polecenie:

dotnet tool update -g microsoft.sqlpackage

Aby odinstalować pakiet SqlPackage, uruchom następujące polecenie:

dotnet tool uninstall -g microsoft.sqlpackage

Instalowanie pakietu SqlPackage przy użyciu przyszłych wersji platformy .NET

pl-PL: Aby zainstalować pakiet SqlPackage z nowszą wersją zestawu .NET SDK, dodaj --allow-roll-forward do polecenia instalacji.

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

Ta opcja umożliwia pakietowi SqlPackage używanie nowszej wersji środowiska uruchomieniowego .NET, jeśli program .NET 8 lub .NET 10 nie jest zainstalowany.

Rozwiązywanie problemów z instalacją

Jeśli podczas instalacji wystąpią problemy, wykonaj następujące kroki:

Upewnij się, że zestaw .NET SDK jest zainstalowany: Sprawdź, czy zestaw .NET SDK jest zainstalowany na maszynie, uruchamiając następujące polecenie:
```
dotnet --list-sdks
```
Jeśli zestaw .NET SDK nie znajduje się na liście, pobierz go i zainstaluj ze strony pobierania zestawu .NET SDK.
Zweryfikuj konfigurację źródła NuGet: SqlPackage jest publikowany w nuget.org jako publiczne źródło NuGet. Może wystąpić błąd wskazujący, że microsoft.sqlpackage nie można odnaleźć:
```
microsoft.sqlpackage is not found in NuGet feeds C:\Program Files(x86)\Microsoft SDKs\NuGetPackages\
```
Upewnij się, że nuget.org jest skonfigurowanym źródłem NuGet dla dotnet. Wyświetl listę skonfigurowanych źródeł NuGet, uruchamiając polecenie:
```
dotnet nuget list source
```
To polecenie powinno wyświetlić listę źródeł NuGet. Poszukaj nuget.org w danych wyjściowych, które są zwykle wyświetlane jako https://api.nuget.org/v3/index.json. Jeśli nuget.org nie ma na liście, dodaj go jako źródło NuGet przy użyciu następującego polecenia:
```
dotnet nuget add source https://api.nuget.org/v3/index.json
```
Ponów próbę instalacji: po zweryfikowaniu instalacji zestawu .NET SDK i konfiguracji źródła NuGet spróbuj ponownie zainstalować pakiet SqlPackage przy użyciu odpowiedniego polecenia:
```
dotnet tool install -g microsoft.sqlpackage
```

Wersje zapoznawcze

Wersje zapoznawcza pakietu SqlPackage są dostępne za pomocą źródła narzędzi dotnet. Aby uzyskać dostęp do wersji zapoznawczych, użyj opcji --prerelease z poleceniem dotnet tool. Aby na przykład zainstalować najnowszą wersję zapoznawcza, uruchom następujące polecenie:

dotnet tool install -g --prerelease microsoft.sqlpackage

Aby zaktualizować pakiet SqlPackage do najnowszej wersji zapoznawczej, uruchom następujące polecenie:

dotnet tool update -g --prerelease microsoft.sqlpackage

Lista wersji zapoznawczych jest dostępna w kanale informacyjnym narzędzi dotnet dla pakietu SqlPackage.

Instalacja, pobieranie plików (alternatywa)

Pakiet SqlPackage jest również przygotowany jako samodzielny pakiet instalacyjny dla systemów Windows, macOS i Linux. Nie jest wymagana żadna instalacja platformy .NET, jednak wymagania dotyczące systemu operacyjnego są takie same jak w przypadku instalacji narzędzia dotnet. Zależności zawarte w tym pobraniu .zip są częściej aktualizowane w narzędziu dotnet dla SqlPackage. Poniższe linki dotyczą najnowszej wersji pakietu SqlPackage:

Platform	Download
Windows .NET 10	plik.zip
Windows	plik .msi
macOS .NET 10	plik.zip
Linux .NET 10	plik.zip

Linux

Pobierz pakiet SqlPackage dla systemu Linux

Wyodrębnij plik i uruchom pakiet SqlPackage. Otwórz nowe okno terminalu i wpisz następujące polecenia:

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

Być może brakuje zależności. Użyj następujących poleceń, aby zainstalować te zależności w zależności od używanej wersji systemu Linux:

Debian:

sudo apt-get install libunwind8

Red Hat:

yum install libunwind
yum install libicu

Ubuntu:

sudo apt-get install libunwind8

macOS

Pobierz pakiet SqlPackage dla systemu macOS
Wyodrębnij plik i uruchom pakiet SqlPackage. Otwórz nowe okno terminalu i wpisz następujące polecenia:
```
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

Ustawienia zabezpieczeń mogą wymagać modyfikacji uruchamiania pakietu SqlPackage w systemie macOS. Użyj następujących poleceń, aby wchodzić w interakcje z usługą Gatekeeper z poziomu wiersza polecenia.

Przed wykonaniem pakietu SqlPackage:
```
sudo spctl --master-disable
```
Po wykonaniu polecenia SqlPackage:
```
sudo spctl --master-enable
```

Windows (.NET 10)

Pobierz pakiet SqlPackage dla systemu Windows
Wyodrębnij plik, klikając prawym przyciskiem myszy plik w Eksploratorze Windows i wybierając polecenie Wyodrębnij wszystko, a następnie wybierz katalog docelowy.
Otwórz nowe okno terminalu i przejdź do lokalizacji, w której wyodrębniono pakiet SqlPackage:
```
> sqlpackage
```

Windows (.NET Framework)

Ta wersja pakietu SqlPackage zawiera standardowe środowisko instalatora systemu Windows i .zip:

Pobieranie i uruchamianie instalatoraDacFramework.msi dla systemu Windows
Otwórz nowe okno wiersza polecenia i uruchom pakiet SqlPackage
- Pakiet SqlPackage jest instalowany w folderze C:\Program Files\Microsoft SQL Server\170\DAC\bin

Odinstalowywanie pakietu SqlPackage

Jeśli pakiet SqlPackage został zainstalowany przy użyciu Instalatora Windows, odinstaluj ten sam sposób, w jaki usuniesz dowolną aplikację systemu Windows.

Jeśli pakiet SqlPackage został zainstalowany przy użyciu .zip lub innego archiwum, usuń pliki.

Środowiska zautomatyzowane

Zainstalowanie wersji narzędzia dotnet pakietu SqlPackage jest zalecane w przypadku zautomatyzowanych środowisk, takich jak potoki ciągłej integracji/ciągłego wdrażania (CI/CD), ze względu na łatwość instalacji i aktualizacji. Jednak opcja pobierania plików może być również używana w zautomatyzowanych środowiskach.

dotnet tool install -g microsoft.sqlpackage

Linki Evergreen są dostępne do pobrania najnowszych wersji pakietu 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 to interfejs wiersza poleceń dla platformy DacFx, który uwidacznia niektóre publiczne interfejsy API DacFx. DacServices (Microsoft.SqlServer.Dac) to powiązany mechanizm integrowania wdrożenia bazy danych z potokiem aplikacji. Interfejs API DacServices jest dostępny w pakiecie za pośrednictwem narzędzia NuGet, Microsoft.SqlServer.DacFx.

Dodanie pakietu NuGet do projektu platformy .NET odbywa się za pomocą interfejsu wiersza polecenia platformy .NET za pomocą następującego polecenia:

dotnet add package Microsoft.SqlServer.DacFx

Obsługiwane systemy operacyjne

Pakiet SqlPackage działa w systemach Windows, macOS i Linux i jest kompilowany przy użyciu platformy .NET 10. Wymagania dotyczące systemu operacyjnego .NET 10 są minimalnymi wymaganiami programu SqlPackage, które mają dodatkowe wymagania ze względu na jego zależności.

Windows (x64)

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

macOS

macOS 14 "Sonoma"+

Linux (x64)

Debian 12+
Red Hat Enterprise Linux 8+
SUSE Linux Enterprise Server 15 SP6+
Ubuntu 22.04+

Dostępne języki

Tę wersję pakietu SqlPackage można zainstalować w następujących językach:

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2026-02-10

Udostępnij przez

Pobieranie i instalowanie pakietu SqlPackage

Instalacja, międzyplatformowa

Instalowanie pakietu SqlPackage przy użyciu przyszłych wersji platformy .NET

Rozwiązywanie problemów z instalacją

Wersje zapoznawcze

Instalacja, pobieranie plików (alternatywa)

Linux

macOS

Windows (.NET 10)

Windows (.NET Framework)

Odinstalowywanie pakietu SqlPackage

Środowiska zautomatyzowane

DacFx

Obsługiwane systemy operacyjne

Windows (x64)

macOS

Linux (x64)

Dostępne języki

Treści powiązane

Sprzężenie zwrotne

Dodatkowe źródła