Télécharger et installer SqlPackage

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.4.92
• Numéro de build : 162.4.92.3
• Date de sortie :  18 septembre 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.

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 :

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 :

• 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 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

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

• En savoir plus sur SqlPackage
• En savoir plus sur SqlPackage dans les pipelines CI/CD
• En savoir plus sur la résolution des problèmes liés à SqlPackage
• Partager des commentaires sur SqlPackage dans le référentiel GitHub DacFx

Déclaration de confidentialité Microsoft