Scaricare e installare SqlPackage

  • Articolo

SqlPackage viene eseguito in Windows, macOS e Linux ed è disponibile per l'installazione tramite dotnet tool o come download zip autonomo. Per informazioni dettagliate sulla versione più recente, vedere le note sulla versione.

  • Numero di versione: 162.2.111
  • Numero di build: 162.2.111.2
  • Data di rilascio: 27 febbraio 2024

SqlPackage viene sviluppato e rilasciato sia per .NET 8 che per .NET Framework. L'installazione della versione sqlPackage di .NET 8 è consigliata tramite il metodo dotnet tool pratico, che è multipiattaforma e facile da aggiornare, oppure tramite il download autonomo portabile .zip. Le versioni sqlPackage di .NET 8 traggono vantaggio dai continui progressi verso le prestazioni e la scalabilità di .NET come parte dell'attenzione per le applicazioni moderne, che contrasta con il supporto della manutenzione di .NET Framework per Windows. La versione di .NET Framework è disponibile solo come programma di installazione di Windows .msi.

Nota

In precedenza, SqlPackage aveva un numero di versione (19) e un numero di build (160.x) distinti. A partire dalla versione 161, il numero di versione di SqlPackage corrisponde al numero di versione di DacFx a cui è associato (ad esempio 162.0.52).

Installazione, multipiattaforma

L'installazione di SqlPackage come strumento dotnet richiede l'installazione di .NET SDK nel computer. L'installazione di SqlPackage come strumento globale lo rende disponibile nel percorso come sqlpackage ed è il metodo consigliato per installare SqlPackage per Windows, macOS e Linux. SqlPackage è disponibile come strumento dotnet per .NET 6 e .NET 8.

Per installare SqlPackage come strumento .NET globale, eseguire il comando seguente:

dotnet tool install -g microsoft.sqlpackage

Altre informazioni sulle opzioni disponibili con il comando dotnet tool install sono disponibili nella documentazione relativa all'installazione dello strumento dotnet.

Per effettuare l'aggiornamento alla versione più recente di SqlPackage, eseguire i comandi seguenti:

dotnet tool update -g microsoft.sqlpackage

Per effettuare la disinstallazione di SqlPackage, eseguire il comando riportato di seguito:

dotnet tool uninstall -g microsoft.sqlpackage

Versioni preliminari

Le versioni di anteprima di SqlPackage sono disponibili con il feed degli strumenti dotnet. Per accedere alle versioni di anteprima, usare l'opzione --prerelease con il comando dotnet tool. Ad esempio, per installare la versione di anteprima più recente, eseguire il comando seguente:

dotnet tool install -g --prerelease microsoft.sqlpackage

Per effettuare l'aggiornamento alla versione più recente di SqlPackage in anteprima, eseguire i comandi seguenti:

dotnet tool update -g --prerelease microsoft.sqlpackage

Un elenco delle versioni di anteprima è disponibile nel feed degli strumenti dotnet per SqlPackage.

Installazione, download di file (alternativa)

SqlPackage è anche preparato come download autonomo per Windows, macOS e Linux. Non è necessaria alcuna installazione di .NET, ma le dipendenze incluse in questo download .zip vengono aggiornate più frequentemente nell'opzione dello strumento dotnet per SqlPackage. I collegamenti seguenti sono relativi alla versione più recente di SqlPackage:

Piattaforma Scarica
Windows .NET 8 .zip file
Windows File .msi
macOS .NET 8 .zip file
Linux .NET 8 .zip file

Linux

  1. Scaricare SqlPackage per Linux

  2. Per estrarre il file e avviare SqlPackage, aprire una nuova finestra del terminale e digitare i comandi seguenti:

    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

    Nota

    È possibile che alcune dipendenze non siano presenti. Usare i comandi seguenti per installare queste dipendenze a seconda della versione di Linux:

    Debian:

    sudo apt-get install libunwind8

    Red Hat:

    yum install libunwind
yum install libicu

    Ubuntu:

    sudo apt-get install libunwind8

macOS

  1. Scaricare SqlPackage per macOS

  2. Per estrarre il file e avviare SqlPackage, aprire una nuova finestra del terminale e digitare i comandi seguenti:

    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

    Nota

    Le impostazioni di sicurezza possono richiedere una modifica per eseguire SqlPackage in macOS. Usare i comandi seguenti per interagire con Gatekeeper dalla riga di comando.

    Prima dell'esecuzione di SqlPackage:

    sudo spctl --master-disable

    Dopo l'esecuzione di SqlPackage:

    sudo spctl --master-enable

Windows (.NET 8)

  1. Scaricare SqlPackage per Windows

  2. Per estrarre il file, fare clic con il pulsante destro del mouse sul file in Esplora risorse, scegliere "Estrai tutto" e selezionare la directory di destinazione.

  3. Aprire una nuova finestra del terminale ed eseguire CD per passare alla posizione in cui è stato estratto SqlPackage:

    > sqlpackage

Windows (.NET Framework)

Questa versione di SqlPackage include un'esperienza di installazione Windows standard e un file ZIP:

  1. Scaricare ed eseguire il programma di installazione DacFramework.msi per Windows
  2. Aprire una nuova finestra del prompt dei comandi ed eseguire SqlPackage
    • SqlPackage viene installato nella cartella C:\Program Files\Microsoft SQL Server\160\DAC\bin

Disinstallare SqlPackage

Se SqlPackage è stato installato usando il programma di installazione di Windows, disinstallarlo come se fosse una qualsiasi applicazione Windows.

Se SqlPackage è stato installato con un file con estensione zip o con un altro archivio, eliminare i file.

Ambienti automatizzati

Sono disponibili i collegamenti classici per scaricare le versioni più recenti di Sqlpackage:

DacFx

SqlPackage è un'interfaccia della riga di comando per il framework DacFx, che espone alcune delle API DacFx pubbliche. DacServices (Microsoft.SqlServer.Dac) è un meccanismo correlato per l'integrazione della distribuzione di database nella pipeline dell'applicazione. L'API DacServices è disponibile in un pacchetto tramite NuGet, Microsoft.SqlServer.DacFx.

L'aggiunta del pacchetto NuGet a un progetto .NET viene eseguita tramite l'interfaccia della riga di comando di .NET con questo comando:

dotnet add package Microsoft.SqlServer.DacFx

Nota

Sono stati pubblicati altri pacchetti NuGet con il nome DacFx: "Microsoft.SqlServer.DacFx.x64" e "Microsoft.SqlServer.DacFx.x86". Il supporto per entrambe le piattaforme è disponibile tramite il pacchetto "Microsoft.SqlServer.DacFx". I nuovi riferimenti devono essere creati per questo pacchetto e non per le varianti x64 o x86.

Sistemi operativi supportati

SqlPackage può essere eseguito in Windows, macOS e Linux ed è compilato con .NET 8. I requisiti del sistema operativo .NET 8 sono requisiti minimi per SqlPackage, che presenta requisiti aggiuntivi a causa delle relative dipendenze.

Windows (x64)

  • Windows 11
  • Windows 10 (1607 e successive)
  • 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 e successive
  • Ubuntu 20.04+

Lingue disponibili

Questa versione di SqlPackage può essere installata nelle lingue seguenti:

SqlPackage .NET 8 Windows:
Cinese (semplificato) | Cinese (tradizionale) | Inglese (Stati Uniti) | Francese | Tedesco | Italiano | Giapponese | Coreano | Portoghese (Brasile) | Russo | Spagnolo

SqlPackage .NET Framework Windows:
Cinese (semplificato) | Cinese (tradizionale) | Inglese (Stati Uniti) | Francese | Tedesco | Italiano | Giapponese | Coreano | Portoghese (Brasile) | Russo | Spagnolo

SqlPackage .NET 8 macOS:
Cinese (semplificato) | Cinese (tradizionale) | Inglese (Stati Uniti) | Francese | Tedesco | Italiano | Giapponese | Coreano | Portoghese (Brasile) | Russo | Spagnolo

SqlPackage .NET 8 Linux:
Cinese (semplificato) | Cinese (tradizionale) | Inglese (Stati Uniti) | Francese | Tedesco | Italiano | Giapponese | Coreano | Portoghese (Brasile) | Russo | Spagnolo

Passaggi successivi

Informativa sulla privacy Microsoft