Delen via

SqlPackage downloaden en installeren

  • Artikel

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 van de .

  • versienummer: 162.5.57
  • buildnummer: 162.5.57.1
  • Releasedatum: 21 november 2024

SqlPackage is ontwikkeld en uitgebracht voor zowel .NET 8 als .NET Framework. Het wordt aanbevolen om de .NET 8 SqlPackage-versie te installeren via de handige dotnet tool methode, die platformoverschrijdend is en eenvoudig te updaten, of via de draagbare.zip download. De SqlPackage-releases van .NET 8 profiteren van de voortdurende vooruitgang in de prestaties en schaalbaarheid van .NET als onderdeel van , gericht op moderne toepassingen, hetgeen contrasteert met de ondersteuning bij onderhoud van .NET Framework voor Windows. De .NET Framework-versie is alleen beschikbaar als een .msi Windows Installer-.

Notitie

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

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. NuGet-bronconfiguratie controleren: zorg ervoor dat nuget.org een geconfigureerde NuGet-bron voor dotnet is. Vermeld de geconfigureerde NuGet-bronnen door het volgende uit te voeren:

    dotnet nuget list source

    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:

Perron Downloaden
Windows .NET 8 .zip bestand
Ramen .msi bestand
macOS .NET 8 .zip bestand
Linux .NET 8 .zip bestand

Linux

  1. SqlPackage voor Linux - downloaden

  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

    Notitie

    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

    Notitie

    Beveiligingsinstellingen moeten mogelijk worden gewijzigd om SqlPackage uit te voeren op macOS. Maak gebruik van de volgende opdrachten om te communiceren met Gatekeeper vanaf de opdrachtregel.

    Voordat u SqlPackage uitvoert:

    sudo spctl --master-disable

    Na het uitvoeren van SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  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\160\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

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

Notitie

Er zijn extra NuGet-pakketten gepubliceerd onder de naam DacFx, 'Microsoft.SqlServer.DacFx.x64' en 'Microsoft.SqlServer.DacFx.x86'. Ondersteuning voor beide platforms wordt gedekt door het pakket Microsoft.SqlServer.DacFx. Er moeten nieuwe verwijzingen naar dit pakket worden gemaakt, niet de x64- of x86-varianten.

Ondersteunde besturingssystemen

SqlPackage wordt uitgevoerd in Windows, macOS en Linux en is gebouwd met .NET 8. De .NET 8-besturingssysteemvereisten 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 12 "Monterey"+

Linux (x64)

  • Debian 11+
  • Red Hat Enterprise Linux 8+
  • SUSE Linux Enterprise Server v12 SP2+
  • Ubuntu 20.04+

Beschikbare talen

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

SqlPackage .NET 8 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 8 macOS:
Chinees (Vereenvoudigd) | Chinees (traditioneel) | Engels (Verenigde Staten) | Frans | Duits | Italiaans | Japanse | Koreaans | Portugees (Brazilië) | Russisch | Spaans

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

Verwante inhoud