Herunterladen und Installieren von SqlPackage

  • Artikel

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.2.111
  • Buildnummer: 162.2.111.2
  • Veröffentlichungsdatum: 27. Februar 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

  1. Laden Sie SqlPackage für Linux herunter.

  2. 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

  1. Laden Sie SqlPackage für macOS herunter.

  2. 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)

  1. Laden Sie SqlPackage für Windows herunter.

  2. 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.

  3. Ö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:

  1. Laden Sie das Installationsprogramm DacFramework.msi für Windows herunter, und führen Sie es aus.
  2. Ö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.

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:

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

Datenschutzerklärung von Microsoft