Herunterladen und Installieren von SqlPackage
SqlPackage wird unter Windows, macOS und Linux ausgeführt und ist über dotnet tool
oder als eigenständiger ZIP-Download zur Installation verfügbar. Weitere Informationen über die neueste Version finden Sie in den Versionshinweisen.
- Versionsnummer: 162.4.92
- Buildnummer: 162.4.92.3
- Veröffentlichungsdatum: 18. September 2024
SqlPackage wird sowohl für .NET 8 als auch für .NET Framework entwickelt und veröffentlicht. Die Installation der SqlPackage-Version für .NET 8 sollte am besten über die bequeme Methode dotnet tool
erfolgen, die plattformübergreifend und einfach zu aktualisieren ist, oder über den portierbaren eigenständigen ZIP-Download. Die SqlPackage-Releases für .NET 8 profitieren von den kontinuierlichen Fortschritten bei Leistung und Skalierbarkeit von .NET im Rahmen des Fokus auf moderne Anwendungen. Dem gegenüber steht die reine Wartungsunterstützung von .NET Framework für Windows. Die .NET Framework-Version ist nur als MSI-Windows-Installationsprogramm verfügbar.
Hinweis
Zuvor hatte SqlPackage eine eindeutige Versionsnummer (19) und Buildnummer (160.x). Ab Version 161 stimmt die Versionsnummer von SqlPackage mit der entsprechenden DacFx-Versionsnummer überein (z. B. 162.0.52).
Installation, plattformübergreifend
Für die Installation von SqlPackage als Dotnet-Tool muss das .NET SDK auf Ihrem Computer installiert sein. Die Installation von SqlPackage als globales Tool macht es in Ihrem Pfad als sqlpackage
verfügbar, und es wird empfohlen, SqlPackage für Windows, macOS und Linux so zu installieren. SqlPackage ist als Dotnet-Tool für .NET 6 und .NET 8 verfügbar.
Führen Sie den folgenden Befehl aus, um SqlPackage als globales .NET-Tool zu installieren:
dotnet tool install -g microsoft.sqlpackage
Weitere Informationen zu den mit dem dotnet tool install
-Befehl verfügbaren Optionen finden Sie in der Dokumentation zur Installation des Dotnet-Tools.
Führen Sie den folgenden Befehl aus, um SqlPackage auf die aktuelle Version zu aktualisieren:
dotnet tool update -g microsoft.sqlpackage
Zum Deinstallieren von SqlPackage führen Sie den folgenden Befehl aus:
dotnet tool uninstall -g microsoft.sqlpackage
Vorschaureleases
Vorschaureleases von SqlPackage sind mit dem Dotnet-Toolfeed verfügbar. Verwenden Sie zum Zugreifen auf Vorschaurelease die --prerelease
-Option mit dem dotnet tool
-Befehl. Um beispielsweise die neueste Vorschauversion zu installieren, führen Sie den folgenden Befehl aus:
dotnet tool install -g --prerelease microsoft.sqlpackage
Führen Sie den folgenden Befehl aus, um SqlPackage auf die aktuelle Vorschauversion zu aktualisieren:
dotnet tool update -g --prerelease microsoft.sqlpackage
Eine Liste der Vorschauversionen ist im Dotnet-Toolfeed für SqlPackage verfügbar.
Installation, Dateidownload (alternativ)
SqlPackage wird auch als eigenständiger Download für Windows, macOS und Linux vorbereitet. Es ist keine .NET-Installation erforderlich. Die in diesem ZIP-Download enthaltenen Abhängigkeiten werden jedoch in der Dotnet-Tooloption für SqlPackage häufiger aktualisiert. Die folgenden Links beziehen sich auf die neueste Version von SqlPackage:
Plattform | Download |
---|---|
Windows .NET 8 | zip-Datei |
Windows | .MSI-Datei |
macOS .NET 8 | zip-Datei |
Linux .NET 8 | zip-Datei |
Linux
Laden Sie SqlPackage für Linux herunter.
Extrahieren Sie die Datei, und starten Sie SqlPackage. Öffnen Sie ein neues Terminalfenster, und geben Sie die folgenden Befehle ein:
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
Hinweis
Möglicherweise fehlen Abhängigkeiten. Verwenden Sie die folgenden Befehle, um diese Abhängigkeiten je nach Ihrer Linux-Version zu installieren:
Debian:
sudo apt-get install libunwind8
Red Hat:
yum install libunwind yum install libicu
Ubuntu:
sudo apt-get install libunwind8
macOS
Laden Sie SqlPackage für macOS herunter.
Extrahieren Sie die Datei, und starten Sie SqlPackage. Öffnen Sie ein neues Terminalfenster, und geben Sie die folgenden Befehle ein:
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
Hinweis
Die Sicherheitseinstellungen müssen möglicherweise geändert werden, um SqlPackage unter macOS auszuführen. Verwenden Sie die folgenden Befehle, um über die Befehlszeile mit Gatekeeper in Interaktion zu treten.
Vor dem Ausführen von SqlPackage:
sudo spctl --master-disable
Nach dem Ausführen von SqlPackage:
sudo spctl --master-enable
Windows (.NET 8)
Laden Sie SqlPackage für Windows herunter.
Extrahieren Sie die Datei, indem Sie mit der rechten Maustaste im Windows Explorer auf die Datei klicken und dann zuerst „Alle extrahieren…“ und dann das Zielverzeichnis auswählen.
Öffnen Sie ein neues Terminalfenster, und wechseln Sie mithilfe des Befehls „cd“ zu dem Speicherort, an dem SqlPackage extrahiert wurde:
> sqlpackage
Windows (.NET Framework)
Dieses Release von SqlPackage enthält das standardmäßige Windows-Installationsprogramm und eine ZIP-Datei:
- Laden Sie das Installationsprogramm DacFramework.msi für Windows herunter, und führen Sie es aus.
- Öffnen Sie ein neues Eingabeaufforderungsfenster, und führen Sie SqlPackage aus.
- SqlPackage wird im Ordner
C:\Program Files\Microsoft SQL Server\160\DAC\bin
installiert.
- SqlPackage wird im Ordner
Deinstallieren von SqlPackage
Wenn Sie SqlPackage mit dem Windows-Installationsprogramm installiert haben, gehen Sie bei der Deinstallation genau wie beim Entfernen einer Windows-Anwendung vor.
Wenn Sie SqlPackage über eine ZIP-Datei oder ein anderes Archiv installiert haben, löschen Sie die Dateien.
Automatisierte Umgebungen
Über die Evergreen-Links können Sie die neuesten Sqlpackage-Versionen herunterladen:
- 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 ist eine Befehlszeilenschnittstelle für das DacFx-Framework, die einige der öffentlichen DacFx-APIs zur Verfügung stellt. DacServices (Microsoft.SqlServer.Dac) ist ein verwandter Mechanismus zum Integrieren der Datenbankbereitstellung in Ihre Anwendungspipeline. Die DacServices-API ist in einem NuGet-Paket verfügbar (Microsoft.SqlServer.DacFx).
Das Hinzufügen des NuGet-Pakets zu einem .NET-Projekt erfolgt über die .NET CLI mit dem folgenden Befehl:
dotnet add package Microsoft.SqlServer.DacFx
Hinweis
Es wurden weitere DacFx-NuGet-Pakete veröffentlicht: „Microsoft.SqlServer.DacFx.x64“ und „Microsoft.SqlServer.DacFx.x86“. Das Paket „Microsoft.SqlServer.DacFx“ unterstützt beide Plattformen. Neue Verweise sollten auf dieses Paket verweisen und nicht auf die x64- oder die x86-Variante.
Unterstützte Betriebssysteme
SqlPackage wird unter Windows, macOS und Linux ausgeführt und wurde mit .NET 8 erstellt. Die Anforderungen an das Betriebssystem von .NET 8 sind Mindestanforderungen für SqlPackage, das aufgrund seiner Abhängigkeiten zusätzliche Anforderungen hat.
Windows (x64)
- Windows 11
- Windows 10 (1607 und höher)
- Windows Server Core 2012 R2+
- Windows Server 2012 R2+
macOS
- macOS 12 „Monterey“ und höher
Linux (x64)
- Debian 11 und höher
- Red Hat Enterprise Linux 8 und höher
- SUSE Linux Enterprise Server v12 SP2 und höher
- Ubuntu 20.04 und höher
Verfügbare Sprachen
Dieses Release von SqlPackage kann in folgenden Sprachen installiert werden:
SqlPackage .NET 8 Windows:
Chinesisch (vereinfacht) | Chinesisch (traditionell) | Englisch (Vereinigte Staaten) | Französisch | Deutsch | Italienisch | Japanisch | Koreanisch | Portugiesisch (Brasilien) | Russisch | Spanisch
SqlPackage .NET Framework Windows:
Chinesisch (vereinfacht) | Chinesisch (traditionell) | Englisch (Vereinigte Staaten) | Französisch | Deutsch | Italienisch | Japanisch | Koreanisch | Portugiesisch (Brasilien) | Russisch | Spanisch
SqlPackage .NET 8 macOS:
Chinesisch (vereinfacht) | Chinesisch (traditionell) | Englisch (Vereinigte Staaten) | Französisch | Deutsch | Italienisch | Japanisch | Koreanisch | Portugiesisch (Brasilien) | Russisch | Spanisch
SqlPackage .NET 8 Linux:
Chinesisch (vereinfacht) | Chinesisch (traditionell) | Englisch (Vereinigte Staaten) | Französisch | Deutsch | Italienisch | Japanisch | Koreanisch | Portugiesisch (Brasilien) | Russisch | Spanisch
Nächste Schritte
- Weitere Informationen zu SqlPackage
- Weitere Informationen zu SqlPackage in CI/CD-Pipelines
- Weitere Informationen zur Problembehandlung mit SqlPackage
- Teilen von Feedback zu SqlPackage im DacFx GitHub-Repository