Scaricare e installare SqlPackage

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.4.92
• Numero di build: 162.4.92.3
• Data di uscita: 18 settembre 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.

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:

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:

• Linux (https://aka.ms/sqlpackage-linux)
• macOS (https://aka.ms/sqlpackage-macos)
• Windows (https://aka.ms/sqlpackage-windows)
• Windows, .NET Framework (https://aka.ms/dacfx-msi)

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

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

• Altre informazioni su sqlpackage
• Altre informazioni su SqlPackage nelle pipeline CI/CD
• Altre informazioni sulla risoluzione dei problemi relativi a SqlPackage
• Condividere commenti e suggerimenti su SqlPackage nel repository GitHub di DacFx

Informativa sulla privacy Microsoft