Dela via

Ladda ned och installera SqlPackage

  • Artikel

SqlPackage körs i Windows, macOS och Linux och kan installeras via dotnet tool eller som en fristående zip-nedladdning. Mer information om den senaste versionen finns i versionsanteckningar.

  • Versionsnummer: 162.5.57
  • Build-nummer: 162.5.57.1
  • Utgivningsdatum: 21 november 2024

SqlPackage har utvecklats och släppts för både .NET 8 och .NET Framework. Installation av .NET 8 SqlPackage-versionen rekommenderas via den praktiska dotnet tool-metoden, som är plattformsoberoende och lätt att uppdatera, eller via bärbara fristående .zip ladda ned. .NET 8 SqlPackage-versionerna drar nytta av de kontinuerliga framstegen inom prestanda och skalbarhet för .NET som en del av fokus på moderna applikationer, till skillnad från underhållsstödet för .NET Framework för Windows. .NET Framework-versionen är endast tillgänglig som ett .msi Windows-installationsprogram.

Not

Tidigare hade SqlPackage ett distinkt versionsnummer (19) och versionsnummer (160.x). Från och med version 161 matchar versionsnumret för SqlPackage det DacFx-versionsnummer som det är associerat med (t.ex. 162.0.52).

Installation, plattformsoberoende

Om du installerar SqlPackage som ett dotnet-verktyg måste .NET SDK- installeras på datorn. Om du installerar SqlPackage som ett globalt verktyg blir det tillgängligt på din sökväg som sqlpackage och är den rekommenderade metoden för att installera SqlPackage för Windows, macOS och Linux. SqlPackage är tillgängligt som ett dotnet-verktyg för .NET 8 och senare versioner.

Kör följande kommando för att installera SqlPackage som ett globalt .NET-verktyg:

dotnet tool install -g microsoft.sqlpackage

Mer information om de alternativ som är tillgängliga med kommandot dotnet tool install finns i installationsdokumentationen för dotnet-verktyget.

Kör följande kommando för att uppdatera SqlPackage till den senaste versionen:

dotnet tool update -g microsoft.sqlpackage

Om du vill avinstallera SqlPackage kör du följande kommando:

dotnet tool uninstall -g microsoft.sqlpackage

Felsöka installation

Om du stöter på problem under installationen följer du dessa steg:

  1. Kontrollera att .NET SDK är installerat: Kontrollera att .NET SDK är installerat på datorn genom att köra följande kommando:

    dotnet --list-sdks

    Om .NET SDK inte visas laddar du ned och installerar det från nedladdningssidan .NET SDK.

  2. Verifiera NuGet-källkonfigurationen: Kontrollera att nuget.org är en konfigurerad NuGet-källa för dotnet. Visa en lista över de konfigurerade NuGet-källorna genom att köra:

    dotnet nuget list source

    Om nuget.org inte visas lägger du till den som en NuGet-källa med hjälp av följande kommando:

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

  3. Försök installera igen: När du har verifierat .NET SDK-installationen och NuGet-källkonfigurationen försöker du installera SqlPackage igen med hjälp av lämpligt kommando:

    dotnet tool install -g microsoft.sqlpackage

Förhandsversioner

Förhandsversioner av SqlPackage är tillgängliga med dotnet-verktygsflödet. Om du vill komma åt förhandsversioner använder du alternativet --prerelease med kommandot dotnet tool. Om du till exempel vill installera den senaste förhandsversionen kör du följande kommando:

dotnet tool install -g --prerelease microsoft.sqlpackage

Kör följande kommando för att uppdatera SqlPackage till den senaste förhandsversionen:

dotnet tool update -g --prerelease microsoft.sqlpackage

En lista över förhandsversioner finns i dotnet-verktygsfeed för SqlPackage.

Installation, filnedladdning (alternativ)

SqlPackage förbereds också som en fristående nedladdning för Windows, macOS och Linux. Ingen .NET-installation krävs, men operativsystemkrav är desamma som dotnet-verktyget installera. Beroenden som ingår i den här .zip nedladdningen uppdateras oftare i dotnet-verktygsalternativet för SqlPackage. Följande länkar är för den senaste versionen av SqlPackage:

Plattform Ladda ned
Windows .NET 8 .zip fil
Windows .msi fil
macOS .NET 8 .zip fil
Linux .NET 8 .zip fil

Linux

  1. Ladda ned SqlPackage för Linux

  2. Extrahera filen och starta SqlPackage, öppna ett nytt terminalfönster och skriv följande kommandon:

    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

    Notis

    Du kanske saknar beroenden. Använd följande kommandon för att installera dessa beroenden beroende på din version av Linux:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Ladda ned SqlPackage för macOS

  2. Extrahera filen och starta SqlPackage, öppna ett nytt terminalfönster och skriv följande kommandon:

    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

    Anteckning

    Säkerhetsinställningar kan kräva ändringar för att köra SqlPackage på macOS. Använd följande kommandon för att interagera med Gatekeeper från kommandoraden.

    Innan du kör SqlPackage:

    sudo spctl --master-disable

    När du har kört SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Ladda ned SqlPackage för Windows

  2. Extrahera filen genom att högerklicka på filen i Utforskaren och välja Extrahera alla... och välja målkatalogen

  3. Öppna ett nytt terminalfönster och cd till den plats där SqlPackage extraherades:

    > sqlpackage

Windows (.NET Framework)

Den här versionen av SqlPackage inkluderar en standardinstallation för Windows och en .zip:

  1. Ladda ned och kör installationsprogrammet för DacFramework.msi för Windows
  2. Öppna ett nytt kommandotolkfönster och kör SqlPackage
    • SqlPackage installeras i mappen C:\Program Files\Microsoft SQL Server\160\DAC\bin

Avinstallera SqlPackage

Om du har installerat SqlPackage med windows-installationsprogrammet avinstallerar du på samma sätt som du tar bort alla Windows-program.

Om du har installerat SqlPackage med en .zip eller ett annat arkiv tar du bort filerna.

Automatiserade miljöer

Evergreen-länkar är tillgängliga för nedladdning av de senaste Sqlpackage-versionerna:

DacFx

SqlPackage är ett kommandoradsgränssnitt för DacFx-ramverket som exponerar några av de offentliga DacFx-API:erna. DacServices (Microsoft.SqlServer.Dac) är en relaterad mekanism för att integrera databasdistribution i din programpipeline. DacServices-API:et är tillgängligt i ett paket via NuGet, Microsoft.SqlServer.DacFx.

Du kan lägga till NuGet-paketet i ett .NET-projekt via .NET CLI med det här kommandot:

dotnet add package Microsoft.SqlServer.DacFx

Obs

Ytterligare NuGet-paket publicerades under DacFx-namnet, "Microsoft.SqlServer.DacFx.x64" och "Microsoft.SqlServer.DacFx.x86". Stöd för båda plattformarna omfattas av paketet "Microsoft.SqlServer.DacFx". Nya referenser ska göras till det här paketet, inte x64- eller x86-varianterna.

Operativsystem som stöds

SqlPackage körs i Windows, macOS och Linux och skapas med .NET 8. Operativsystemet .NET 8 är minimikrav för SqlPackage, som har extra krav på grund av dess beroenden.

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+

Tillgängliga språk

Den här versionen av SqlPackage kan installeras på följande språk:

SqlPackage .NET 8 Windows:
kinesiska (förenklad) | kinesiska (traditionell) | engelska (USA) | franska | tyska | italienska | japanska | koreanska | portugisiska (Brasilien) | ryska | spanska

SqlPackage .NET Framework Windows:
kinesiska (förenklad) | kinesiska (traditionell) | engelska (USA) | franska | tyska | italienska | japanska | koreanska | portugisiska (Brasilien) | ryska | spanska

SqlPackage .NET 8 macOS:
kinesiska (förenklad) | kinesiska (traditionell) | engelska (USA) | franska | tyska | italienska | japanska | koreanska | portugisiska (Brasilien) | ryska | spanska

SqlPackage .NET 8 Linux:
kinesiska (förenklad) | kinesiska (traditionell) | engelska (USA) | franska | tyska | italienska | japanska | koreanska | portugisiska (Brasilien) | ryska | spanska

Relaterat innehåll