Télécharger et installer SqlPackage

  • Article

SqlPackage s’exécute sur Windows, macOS et Linux. Il peut être installé via dotnet tool ou un téléchargement zip autonome. Pour plus d’informations sur la dernière version, consultez les notes de publication.

  • Numéro de version : 162.2.111
  • Numéro de build : 162.2.111.2
  • Date de publication : 27 février 2024

SqlPackage est développé et publié pour .NET 8 et .NET Framework. L’installation de la version de .NET 8 SqlPackage est recommandée via la méthode pratique dotnet tool, qui est multiplateforme et facile à mettre à jour, ou via le téléchargement .zip autonome portable. Les versions de .NET 8 SqlPackage bénéficient des avancées continues vers les performances et la scalabilité de .NET dans le cadre de la concentration sur les applications modernes, qui contrastent avec la prise en charge de maintenance de .NET Framework pour Windows. La version de .NET Framework n’est disponible qu’en tant que .msi Windows installer.

Remarque

SqlPackage avait auparavant un numéro de version (19) et un numéro de build distincts (160.x). À compter de la version 161, le numéro de version de SqlPackage correspond au numéro de version de DacFx auquel il est associé (par exemple 162.0.52).

Installation, multiplateforme

L’installation de SqlPackage en tant qu’outil dotnet nécessite l’installation du kit de développement logiciel (SDK) .NET sur votre ordinateur. L’installation de SqlPackage en tant qu’outil global le rend disponible sur votre chemin d’accès en tant que sqlpackage. Il s’agit de la méthode recommandée pour installer SqlPackage pour Windows, macOS et Linux. SqlPackage est disponible en tant qu’outil dotnet pour .NET 6 et .NET 8.

Pour installer SqlPackage en tant qu’outil .NET global, exécutez la commande suivante :

dotnet tool install -g microsoft.sqlpackage

Pour plus d’informations sur les options disponibles avec la commande dotnet tool install, consultez la documentation d’installation de l’outil dotnet.

Pour mettre à jour SqlPackage vers la dernière version, exécutez la commande suivante :

dotnet tool update -g microsoft.sqlpackage

Pour désinstaller SqlPackage, exécutez la commande suivante :

dotnet tool uninstall -g microsoft.sqlpackage

Versions précommerciales

Les prévisions de SqlPackage sont disponibles avec le flux d’outils dotnet. Pour accéder à une préversion, utilisez l’option --prerelease avec la commande dotnet tool. Par exemple, pour installer la dernière préversion, exécutez la commande suivante :

dotnet tool install -g --prerelease microsoft.sqlpackage

Pour mettre à jour SqlPackage vers la dernière préversion, exécutez la commande suivante :

dotnet tool update -g --prerelease microsoft.sqlpackage

Une liste des préversions est disponible sur le flux d’outils dotnet pour SqlPackage.

Installation, téléchargement de fichiers (alternative)

SqlPackage est également préparé en tant que téléchargement autonome pour Windows, macOS et Linux. Aucune installation de .NET n’est requise. Toutefois, les dépendances incluses dans ce téléchargement .zip sont mises à jour plus fréquemment dans l’option d’outil dotnet pour SqlPackage. Les liens suivants concernent la dernière version de SqlPackage :

Plateforme Télécharger
Windows .NET 8 Fichier zip
Windows Fichier .msi
macOS .NET 8 Fichier zip
Linux .NET 8 Fichier zip

Linux

  1. Télécharger SqlPackage pour Linux

  2. Extrayez le fichier et lancez SqlPackage, ouvrez une nouvelle fenêtre de Terminal et tapez les commandes suivantes :

    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

    Remarque

    Vous avez peut-être des dépendances manquantes. Utilisez les commandes suivantes pour installer ces dépendances selon votre version de Linux :

    Debian :

    sudo apt-get install libunwind8

    Red Hat :

    yum install libunwind
yum install libicu

    Ubuntu :

    sudo apt-get install libunwind8

macOS

  1. Télécharger SqlPackage pour macOS

  2. Extrayez le fichier et lancez SqlPackage, ouvrez une nouvelle fenêtre de Terminal et tapez les commandes suivantes :

    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

    Remarque

    Les paramètres de sécurité peuvent nécessiter une modification pour exécuter SqlPackage sur macOS. Utilisez les commandes suivantes pour interagir avec Gatekeeper à partir de la ligne de commande.

    Avant d’exécuter SqlPackage :

    sudo spctl --master-disable

    Après l’exécution de SqlPackage :

    sudo spctl --master-enable

Windows (.NET 8)

  1. Télécharger SqlPackage pour Windows

  2. Pour extraire le fichier, cliquez avec le bouton droit sur le celui-ci dans l’Explorateur Windows, puis sélectionnez l’option « Extraire tout... » et sélectionnez le répertoire cible

  3. Ouvrez une nouvelle fenêtre de terminal et exécutez une commande cd sur l’emplacement où SqlPackage a été extrait :

    > sqlpackage

Windows (.NET Framework)

Cette version de SqlPackage comprend une expérience du programme d’installation Windows standard et un fichier .zip :

  1. Téléchargez et exécutez le programme d’installation DacFramework.msi pour Windows
  2. Ouvrez une nouvelle fenêtre d’invite de commandes et exécutez SqlPackage
    • SqlPackage est installé dans le dossier C:\Program Files\Microsoft SQL Server\160\DAC\bin

Désinstaller SqlPackage

Si vous avez installé SqlPackage à l’aide du programme d’installation Windows, alors désinstallez-le de la même manière que n’importe quelle application Windows.

Si vous avez installé SqlPackage avec un fichier .zip ou une autre archive, supprimez les fichiers.

Environnements automatisés

Les liens persistants sont disponibles pour télécharger les dernières versions de SqlPackage :

DacFx

SqlPackage est une interface de ligne de commande pour l’infrastructure DacFx, exposant certaines API DacFx publiques. DacServices (Microsoft. SqlServer. DAC) est un mécanisme associé pour intégrer le déploiement de base de données à votre pipeline d’application. L’API DacServices est disponible dans un package via NuGet,Microsoft.SqlServer.DacFx.

L’ajout du package NuGet à un projet .NET s’effectue via l’interface CLI .NET avec cette commande :

dotnet add package Microsoft.SqlServer.DacFx

Notes

Des packages NuGet supplémentaires ont été publiés sous le nom DacFx, « Microsoft.SqlServer.DacFx.x64 » et « Microsoft.SqlServer.DacFx.x86 ». La prise en charge des deux plateformes est traitée avec le package « Microsoft.SqlServer.DacFx ». De nouvelles références doivent être apportées à ce package, et pas aux variantes x64 ou x86.

Systèmes d’exploitation pris en charge

SqlPackage s’exécute sur Windows, macOS et Linux et est construit à l’aide de .NET 8. Les exigences .NET 8 OS sont des minimales pour SqlPackage, lesquelles présentent des exigences supplémentaires en raison de ses dépendances.

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+

Langues disponibles

Vous pouvez installer cette version de SqlPackage dans les langues suivantes :

SqlPackage .NET 8 Windows :
Chinois (simplifié) | Chinois (traditionnel) | Anglais (États-Unis) | Français | Allemand | Italien | Japonais | Coréen | Portugais (Brésil) | Russe | Espagnol

SqlPackage .NET Framework Windows :
Chinois (simplifié) | Chinois (traditionnel) | Anglais (États-Unis) | Français | Allemand | Italien | Japonais | Coréen | Portugais (Brésil) | Russe | Espagnol

SqlPackage .NET 8 macOS :
Chinois (simplifié) | Chinois (traditionnel) | Anglais (États-Unis) | Français | Allemand | Italien | Japonais | Coréen | Portugais (Brésil) | Russe | Espagnol

SqlPackage .NET 8 Linux :
Chinois (simplifié) | Chinois (traditionnel) | Anglais (États-Unis) | Français | Allemand | Italien | Japonais | Coréen | Portugais (Brésil) | Russe | Espagnol

Étapes suivantes

Déclaration de confidentialité Microsoft