Delen via

SqlPackage downloaden en installeren

SqlPackage wordt uitgevoerd in Windows, macOS en Linux en is beschikbaar om te installeren via dotnet tool of als zelfstandige zip-download. Zie voor meer informatie over de nieuwste release de releaseopmerkingen.

  • Versienummer: 170.3.93
  • Buildnummer: 170.3.93.6
  • Releasedatum: 10 februari 2026

SqlPackage is ontwikkeld en uitgebracht voor zowel .NET als .NET Framework. Het installeren van de .NET 10 SqlPackage-versie wordt aanbevolen via de handige dotnet tool methode, die platformoverschrijdend en eenvoudig kan worden bijgewerkt, of via de draagbare zelf-ingesloten .zip downloaden. De .NET 10 SqlPackage-releases profiteren van de voortdurende vooruitgang naar de prestaties en schaalbaarheid van .NET als onderdeel van de focus op moderne toepassingen, wat in tegenstelling tot de onderhoudsondersteuning van .NET Framework voor Windows. De .NET Framework-versie is alleen beschikbaar als een .msi Windows Installer-.

Note

Voorheen had SqlPackage een uniek versienummer (19) en buildnummer (160.x). Vanaf versie 161 komt het versienummer van SqlPackage overeen met het DacFx-versienummer waarmee het is gekoppeld (bijvoorbeeld 162.0.52).

Installatie, platformonafhankelijk

Voor het installeren van SqlPackage als een dotnet-hulpprogramma moet de .NET SDK- op uw computer worden geïnstalleerd. Als u SqlPackage installeert als een globaal hulpprogramma, kunt u deze als sqlpackage beschikbaar maken op uw pad. Dit is de aanbevolen methode voor het installeren van SqlPackage voor Windows, macOS en Linux. SqlPackage is beschikbaar als een dotnet-hulpprogramma voor .NET 8 en latere versies.

Als u SqlPackage wilt installeren als een globaal .NET-hulpprogramma, voert u de volgende opdracht uit:

dotnet tool install -g microsoft.sqlpackage

Meer informatie over de opties die beschikbaar zijn met de opdracht dotnet tool install vindt u in de dotnet tool install documentation.

Voer de volgende opdracht uit om SqlPackage bij te werken naar de nieuwste versie:

dotnet tool update -g microsoft.sqlpackage

Voer de volgende opdracht uit om SqlPackage te verwijderen:

dotnet tool uninstall -g microsoft.sqlpackage

SqlPackage installeren met toekomstige releases van .NET

Als u SqlPackage wilt installeren met een nieuwere versie van de .NET SDK, voegt u deze toe --allow-roll-forward aan de installatieopdracht:

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

Met deze optie kan SqlPackage een nieuwere versie van de .NET-runtime gebruiken als .NET 8 of .NET 10 niet is geïnstalleerd.

Problemen met de installatie oplossen

Als u problemen ondervindt tijdens de installatie, voert u de volgende stappen uit:

  1. Zorg ervoor dat .NET SDK is geïnstalleerd: Controleer of de .NET SDK op uw computer is geïnstalleerd door de volgende opdracht uit te voeren:

    dotnet --list-sdks

    Als de .NET SDK niet wordt vermeld, downloadt en installeert u deze vanaf de .NET SDK-downloadpagina.

  2. Controleer de NuGet-bronconfiguratie: SqlPackage wordt gepubliceerd naar nuget.org, een openbare NuGet-feed. Mogelijk treedt er een fout op die aangeeft dat microsoft.sqlpackage deze niet kan worden gevonden:

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

    Zorg ervoor dat dit nuget.org een geconfigureerde NuGet-bron is voor dotnet. Vermeld de geconfigureerde NuGet-bronnen door het volgende uit te voeren:

    dotnet nuget list source

    Met deze opdracht moet een lijst met NuGet-bronnen worden weergegeven. Zoek naar nuget.org in de uitvoer, waar het meestal wordt vermeld als https://api.nuget.org/v3/index.json. Als nuget.org niet wordt vermeld, voegt u deze toe als een NuGet-bron met behulp van de volgende opdracht:

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

  3. Installeer opnieuw: Nadat u de .NET SDK-installatie en NuGet-bronconfiguratie hebt gecontroleerd, installeert u SqlPackage opnieuw met de juiste opdracht:

    dotnet tool install -g microsoft.sqlpackage

Preview-versies

Preview-versies van SqlPackage zijn beschikbaar met de dotnet-hulpprogrammafeed. Als u preview-versies wilt openen, gebruikt u de optie --prerelease met de opdracht dotnet tool. Als u bijvoorbeeld de nieuwste preview-versie wilt installeren, voert u de volgende opdracht uit:

dotnet tool install -g --prerelease microsoft.sqlpackage

Voer de volgende opdracht uit om SqlPackage bij te werken naar de nieuwste preview-versie:

dotnet tool update -g --prerelease microsoft.sqlpackage

Er is een lijst met preview-releases beschikbaar in de dotnet-hulpprogrammafeed voor SqlPackage.

Installatie, bestand downloaden (alternatief)

SqlPackage is ook voorbereid als een zelfstandige download voor Windows, macOS en Linux. Er is geen .NET-installatie vereist, hoewel de besturingssysteemvereisten dezelfde zijn als de dotnet-hulpprogramma-installatie. De afhankelijkheden die in deze .zip download zijn opgenomen worden vaker bijgewerkt in de dotnet-tooloptie voor SqlPackage. De volgende koppelingen zijn voor de nieuwste versie van SqlPackage:

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

Linux

  1. Download SqlPackage voor Linux

  2. Pak het bestand uit en start SqlPackage. Open een nieuw Terminal-venster en typ de volgende opdrachten:

    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

    Mogelijk ontbreken er afhankelijkheden. Gebruik de volgende opdrachten om deze afhankelijkheden te installeren, afhankelijk van uw versie van Linux:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Download SqlPackage voor macOS

  2. Pak het bestand uit en start SqlPackage. Open een nieuw Terminal-venster en typ de volgende opdrachten:

    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

    Beveiligingsinstellingen moeten mogelijk worden gewijzigd om SqlPackage uit te voeren op macOS. Gebruik de volgende commando's om te interageren met Gatekeeper vanaf de opdrachtregel.

    Voordat u SqlPackage uitvoert:

    sudo spctl --master-disable

    Na het uitvoeren van SqlPackage:

    sudo spctl --master-enable

Windows (.NET 10)

  1. Download SqlPackage voor Windows

  2. Pak het bestand uit door met de rechtermuisknop op het bestand in Windows Verkenner te klikken en 'Alles uitpakken...' te selecteren en de doelmap te selecteren

  3. Open een nieuw Terminal-venster en cd naar de locatie waar SqlPackage is geëxtraheerd:

    > sqlpackage

Windows (.NET Framework)

Deze release van SqlPackage bevat een standaard Windows-installatie-ervaring en een .zip:

  1. Het DacFramework.msi-installatieprogramma voor Windows downloaden en uitvoeren
  2. Open een nieuw opdrachtpromptvenster en voer SqlPackage uit
    • SqlPackage is geïnstalleerd in de map C:\Program Files\Microsoft SQL Server\170\DAC\bin

SqlPackage verwijderen

Als u SqlPackage hebt geïnstalleerd met windows installer, verwijdert u dezelfde manier als u een Windows-toepassing verwijdert.

Als u SqlPackage hebt geïnstalleerd met een .zip of een ander archief, verwijdert u de bestanden.

Geautomatiseerde omgevingen

Het installeren van de dotnet-hulpprogrammaversie van SqlPackage wordt aanbevolen voor geautomatiseerde omgevingen, zoals CI/CD-pijplijnen, vanwege het gemak van de installatie en update. De optie voor het downloaden van bestanden kan echter ook worden gebruikt in geautomatiseerde omgevingen.

dotnet tool install -g microsoft.sqlpackage

Er zijn altijd groene koppelingen beschikbaar voor het downloaden van de nieuwste SqlPackage-versies:

DacFx

SqlPackage is een opdrachtregelinterface voor het DacFx-framework, met een aantal van de openbare DacFx-API's. DacServices (Microsoft.SqlServer.Dac) is een gerelateerd mechanisme voor het integreren van database-implementatie in uw toepassingspijplijn. De DacServices-API is beschikbaar in een pakket via NuGet, Microsoft.SqlServer.DacFx.

Het toevoegen van het NuGet-pakket aan een .NET-project wordt uitgevoerd via de .NET CLI met deze opdracht:

dotnet add package Microsoft.SqlServer.DacFx

Ondersteunde besturingssystemen

SqlPackage wordt uitgevoerd op Windows, macOS en Linux en is gebouwd met .NET 10. De vereisten voor het .NET 10-besturingssysteem zijn minimale vereisten voor SqlPackage, die extra vereisten heeft vanwege de afhankelijkheden.

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+

Beschikbare talen

Deze versie van SqlPackage kan worden geïnstalleerd in de volgende talen:

SqlPackage .NET 10 Windows:
Chinees (Vereenvoudigd) | Chinees (traditioneel) | Engels (Verenigde Staten) | Frans | Duits | Italiaans | Japanse | Koreaans | Portugees (Brazilië) | Russisch | Spaans

SqlPackage .NET Framework Windows:
Chinees (Vereenvoudigd) | Chinees (traditioneel) | Engels (Verenigde Staten) | Frans | Duits | Italiaans | Japanse | Koreaans | Portugees (Brazilië) | Russisch | Spaans

SqlPackage .NET 10 macOS:
Chinees (Vereenvoudigd) | Chinees (traditioneel) | Engels (Verenigde Staten) | Frans | Duits | Italiaans | Japanse | Koreaans | Portugees (Brazilië) | Russisch | Spaans

SqlPackage .NET 10 Linux:
Chinees (Vereenvoudigd) | Chinees (traditioneel) | Engels (Verenigde Staten) | Frans | Duits | Italiaans | Japanse | Koreaans | Portugees (Brazilië) | Russisch | Spaans

Verwante inhoud

  • Last updated on