Configuration système requise, installation et fichiers de pilote
Cet article décrit les pilotes ODBC qui se connectent à SQL Server.
Compatibilité des versions de SQL
La compatibilité d’un pilote signifie qu’il a été testé sur les versions existantes de SQL au moment de sa publication. Les versions de SQL Server tentent généralement de conserver la compatibilité descendante avec les pilotes clients existants. Toutefois, les nouvelles fonctionnalités de SQL Server peuvent ne pas être disponibles avec les anciens pilotes clients.
| Version de base de données → ↓ Version du pilote |
Azure SQL Database | Azure Synapse Analytics | Azure SQL Managed Instance | SQL Server 2022 | SQL Server 2019 | SQL Server 2017 | SQL Server 2016 | SQL Server 2014 | SQL Server 2012 | SQL Server 2008 R2 | SQL Server 2008 | SQL Server 2005 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 18.4 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 18.3 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 18.2 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 18.1 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 18.0 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.10 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.9 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17.8 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17,7 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17.6 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17.5 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17.4 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17.3 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||
| 17.2 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.1 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17,0 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 13.1 | Oui | Oui | Oui | Oui | Oui | Oui | ||||||
| 13 | Oui | Oui | Oui | Oui | Oui | |||||||
| 11 | Oui | Oui | Oui | Oui | Oui |
Détails de la chaîne de connexion
Le nom du pilote que vous spécifiez dans une chaîne de connexion est l’un des noms suivants :
ODBC Driver 11 for SQL ServerODBC Driver 13 for SQL Server(pour 13 et 13.1)ODBC Driver 17 for SQL ServerODBC Driver 18 for SQL Server
Systèmes d’exploitation pris en charge
La matrice suivante indique la compatibilité des versions du pilote avec les différentes versions des systèmes d’exploitation Windows :
| Système d’exploitation → ↓ Version du pilote |
Windows Server 2022 | Windows Server 2019 | Windows Server 2016 | Windows Server 2012 R2 | Windows Server 2012 | Windows Server 2008 R2 | Windows 11 | Windows 10 | Windows 8.1 | Windows 7 | Windows Vista SP2 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 18.4 | Oui | Oui | Oui | Oui | Oui | ||||||
| 18.3 | Oui | Oui | Oui | Oui | Oui | Oui | |||||
| 18.2 | Oui | Oui | Oui | Oui | Oui | Oui | |||||
| 18.1 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 18.0 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.10 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.9 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.8 | Oui | Oui | Oui | Oui | Oui | Oui | |||||
| 17,7 | Oui | Oui | Oui | Oui | Oui | Oui | |||||
| 17.6 | Oui | Oui | Oui | Oui | Oui | Oui | |||||
| 17.5 | Oui | Oui | Oui | Oui | Oui | Oui | |||||
| 17.4 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.3 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | Oui | |||
| 17.2 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17.1 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 17,0 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 13.1 | Oui | Oui | Oui | Oui | Oui | Oui | Oui | ||||
| 13 | Oui | Oui | Oui | Oui | |||||||
| 11 | Oui | Oui | Oui | Oui |
Installation de Microsoft ODBC Driver for SQL Server
Le pilote est installé lorsque vous exécutez msodbcsql.msi à partir de l’un des liens Téléchargements pour Windows.
Notes
Si vous possédez la version 17.1.0.1 ou une version antérieure du pilote, il est recommandé de la désinstaller manuellement avant d’installer la version plus récente.
Côte à côte avec Native Client
Le pilote peut être installé côte à côte avec SQL Server Native Client. Les versions principales du pilote (11, 13, 17, 18) peuvent également être installées côte à côte.
Quand vous appelez msodbcsql.msi, seuls les composants clients sont installés par défaut. Les composants clients sont des fichiers qui prennent en charge l’exécution d’une application développée à l’aide du pilote. Pour installer les composants du SDK, spécifiez ADDLOCAL=ALL sur la ligne de commande. Voici un exemple.
msiexec /i msodbcsql.msi ADDLOCAL=ALL
Licence utilisateur final
Spécifiez IACCEPTMSODBCSQLLICENSETERMS=YES pour accepter les termes de la licence utilisateur final si vous utilisez l’option /passive, /qn, /qb ou /qr pour l’installation. Cette option doit être spécifiée tout en majuscules. Voici un exemple.
msiexec /quiet /passive /qn /i msodbcsql.msi IACCEPTMSODBCSQLLICENSETERMS=YES ADDLOCAL=ALL
Désinstallation sans assistance
L’exemple suivant montre comment effectuer une désinstallation sans assistance.
msiexec /quiet /passive /qn /uninstall msodbcsql.msi
Indication de la dépendance
Quand une application utilise le pilote, elle doit indiquer qu’elle dépend du pilote par le biais de l’option d’installation APPGUID. Cette indication permet au programme d’installation du pilote de signaler les applications dépendantes avant la désinstallation. Pour spécifier une dépendance vis-à-vis du pilote, définissez le paramètre de ligne de commande APPGUID sur votre code de produit lors de l’installation sans assistance du pilote. Un code de produit doit être créé lors de l'utilisation de Microsoft Installer pour regrouper votre programme d'installation d'application. Voici un exemple.
msiexec /i msodbcsql.msi APPGUID={ <Your dependent application's APPGUID> }
Outils en ligne de commande : sqlcmd.exe et bcp.exe
Les outils bcp.exe et sqlcmd.exe à utiliser avec le pilote sont téléchargeables aux emplacements suivants : Utilitaires de ligne de commande Microsoft 11 pour SQL Server, Utilitaires de ligne de commande Microsoft 13 pour SQL Server et Utilitaires de ligne de commande Microsoft 13.1 pour SQL Server. Le pilote est un composant requis pour pouvoir installer sqlcmd.exe et bcp.exe.
bcp.exe et sqlcmd.exe sont installés dans le sous-dossier 110\Tools de %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC pour la version 11 et 130\Tools pour les versions 13 et 13.1.
Une application qui utilise les fonctions BCP doit spécifier le pilote à partir de la même version que celle fournie avec le fichier d’en-tête et la bibliothèque utilisés pour compiler l’application.
Par exemple, si vous compilez une application ODBC avec msodbcsql11.lib et msodbcsql.h, utilisez DRIVER={ODBC Driver 11 for SQL Server} dans la chaîne de connexion.
Composants de Microsoft ODBC Driver for SQL Server sur Windows
Le pilote ODBC sur Windows contient les composants suivants :
| Composant | Description |
|---|---|
msodbcsql18.dll oumsodbcsql17.dll oumsodbcsql13.dll oumsodbcsql11.dll |
Fichier DDL (Dynamic-Link Library) contenant l’ensemble des fonctionnalités du pilote. Ce fichier est installé dans %SYSTEMROOT%\System32. |
msodbcdiag18.dll oumsodbcdiag17.dll oumsodbcdiag13.dll oumsodbcdiag11.dll |
Fichier bibliothèque de liens dynamiques (DLL) contenant l’interface de diagnostics (traçage) du pilote. Ce fichier est installé dans %SYSTEMROOT%\System32. |
msodbcsqlr18.rll oumsodbcsqlr17.rll oumsodbcsqlr13.rll oumsodbcsqlr11.rll |
Fichier de ressources qui accompagne la bibliothèque du pilote. Ce fichier est installé dans %SYSTEMROOT%\System32\1033. |
s13ch_msodbcsql.chm ous11ch_msodbcsql.chm |
Fichier d’aide de l’Assistant Source de données qui explique comment créer une source de données pour le pilote. Ce fichier est installé dans %SYSTEMROOT%\System32\1033REMARQUE : il n’existe aucun fichier chm pour le pilote ODBC 17 et versions ultérieures. |
msodbcsql.h |
Fichier d’en-tête qui contient toutes les nouvelles définitions nécessaires à l’utilisation du pilote. Remarque : vous ne pouvez pas faire référence à msodbcsql.h et odbcss.h dans le même programme.msodbcsql.h pour le pilote ODBC 18 est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK.msodbcsql.h pour le pilote ODBC 17 est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK.msodbcsql.h pour le pilote ODBC 13 est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.msodbcsql.h pour le pilote ODBC 11 est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK. |
msodbcsql18.lib oumsodbcsql17.lib oumsodbcsql13.lib oumsodbcsql11.lib |
Fichier bibliothèque nécessaire pour appeler les fonctions de l’utilitaire bcp qui font partie du pilote. Remarque : si vous référencez cette bibliothèque de code dans votre programme, vérifiez qu’il se trouve dans votre chemin système et dans le chemin système des utilisateurs qui utilisent l’application. msodbcsql18.lib est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK.msodbcsql17.lib est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK.msodbcsql13.lib est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.msodbcsql11.lib est installé dans %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK. |