Leggere in inglese

Condividi tramite

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.5.57
  • Numero di build: 162.5.57.1
  • Data di rilascio: 21 novembre 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 8 e versioni successive.

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

Bash 
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:

Bash 
dotnet tool update -g microsoft.sqlpackage

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

Bash 
dotnet tool uninstall -g microsoft.sqlpackage

Risolvere i problemi di installazione

Se si verificano problemi durante l'installazione, seguire questa procedura:

  1. Assicurarsi che .NET SDK sia installato: verificare che .NET SDK sia installato nel computer eseguendo il comando seguente:

    Bash 
    dotnet --list-sdks

    Se .NET SDK non è elencato, scaricarlo e installarlo dalla pagina di download di .NET SDK .

  2. Verificare la configurazione dell'origine NuGet: assicurarsi che nuget.org sia un'origine NuGet configurata per dotnet. Per elencare le origini NuGet configurate, eseguire:

    Bash 
    dotnet nuget list source

    Se nuget.org non è elencato, aggiungerlo come origine NuGet usando il comando seguente:

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

  3. ripetere l'installazione: dopo aver verificato l'installazione di .NET SDK e la configurazione dell'origine NuGet, riprovare a installare SqlPackage usando il comando appropriato:

    Bash 
    dotnet tool install -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:

Bash 
dotnet tool install -g --prerelease microsoft.sqlpackage

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

Bash 
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 è richiesta alcuna installazione .NET, tuttavia, i requisiti del sistema operativo sono uguali a quelli dell'installazione dello strumento dotnet . Le dipendenze incluse in questo download .zip vengono aggiornate più frequentemente nell'opzione di strumento dotnet per SqlPackage. I collegamenti seguenti sono relativi alla versione più recente di SqlPackage:

Piattaforma Scarica
Windows .NET 8 .zip file
Finestre 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:

    Bash 
    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

    Potrebbero mancare dipendenze. Usare i comandi seguenti per installare queste dipendenze a seconda della versione di Linux:

    Debian:

    Bash 
    sudo apt-get install libunwind8

    Red Hat:

    Bash 
    yum install libunwind
yum install libicu

    Ubuntu:

    Bash 
    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:

    Bash 
    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 potrebbero richiedere modifiche per eseguire SqlPackage in macOS. Usare i comandi seguenti per interagire con Gatekeeper dalla riga di comando.

    Prima dell'esecuzione di SqlPackage:

    Bash 
    sudo spctl --master-disable

    Dopo l'esecuzione di SqlPackage:

    Bash 
    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:

    Prompt dei comandi di Windows 
    > 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:

Prompt dei comandi di Windows 
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

Contenuto correlato