Utilisation du pilote JDBC
Cette section fournit des instructions de démarrage rapide pour une connexion simple à une base de données SQL Server à l’aide de Pilote Microsoft JDBC pour SQL Server. Avant de vous connecter à une base de données SQL Server, vous devez installer SQL Server sur votre ordinateur local ou un serveur ; par ailleurs, le pilote JDBC doit également être installé sur votre ordinateur local.
Choisir le fichier JAR approprié
Microsoft JDBC Driver fournit différents fichiers JAR à utiliser en correspondance avec les paramètres Java Runtime Environment (JRE) choisis :
Microsoft JDBC Driver 12.8 pour SQL Server fournit les fichiers bibliothèques de classes mssql-jdbc-12.8.0.jre8.jar et mssql-jdbc-12.8.0.jre11.jar.
Microsoft JDBC Driver 12.6 pour SQL Server fournit les fichiers bibliothèques de classes mssql-jdbc-12.6.0.jre8.jar et mssql-jdbc-12.6.0.jre11.jar.
Microsoft JDBC Driver 12.4 pour SQL Server fournit les fichiers bibliothèques de classes mssql-jdbc-12.4.0.jre8.jar et mssql-jdbc-12.4.0.jre11.jar.
Microsoft JDBC Driver 12.2 pour SQL Server fournit les fichiers bibliothèques de classes mssql-jdbc-12.2.0.jre8.jar et mssql-jdbc-12.2.0.jre11.jar.
Microsoft JDBC Driver 11.2 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar et mssql-jdbc-11.2.0.jre18.jar.
Microsoft JDBC Driver 10.2 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar et mssql-jdbc-10.2.0.jre17.jar.
Microsoft JDBC Driver 9.4 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar et mssql-jdbc-9.4.1.jre16.jar.
Microsoft JDBC Driver 9.2 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar et mssql-jdbc-9.2.1.jre15.jar.
Microsoft JDBC Driver 8.4 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar et mssql-jdbc-8.4.1.jre14.jar.
Microsoft JDBC Driver 8.2 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar et mssql-jdbc-8.2.2.jre13.jar.
Microsoft JDBC Driver 7.4 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar et mssql-jdbc-7.4.1.jre12.jar.
Microsoft JDBC Driver 7.2 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-7.2.2.jre8.jar et mssql-jdbc-7.2.2.jre11.jar.
Microsoft JDBC Driver 7.0 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-7.0.0.jre8.jar et mssql-jdbc-7.0.0.jre10.jar.
Microsoft JDBC Driver 6.4 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar et mssql-jdbc-6.4.0.jre9.jar.
Microsoft JDBC Driver 6.2 pour SQL Server fournit les fichiers bibliothèque de classes mssql-jdbc-6.2.2.jre7.jar et mssql-jdbc-6.2.2.jre8.jar.
Microsoft JDBC Driver 6.0 et 4.2 pour SQL Server fournissent les fichiers bibliothèque de classes sqljdbc41.jar et sqljdbc42.jar.
Microsoft JDBC Driver 4.1 pour SQL Server fournit le fichier bibliothèque de classes sqljdbc41.jar.
Votre choix va déterminer les fonctionnalités disponibles. Pour plus d'informations sur le fichier JAR à choisir, consultez Configuration requise pour le pilote JDBC.
Définition de Classpath
Les fichiers JAR de Microsoft JDBC Driver ne font pas partie du kit SDK Java et doivent être précisés dans le classpath de l’application utilisateur.
Avec JDBC Driver 12.8, incluez dans le classpath mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar.
Avec JDBC Driver 12.6, incluez dans le classpath mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.
Avec JDBC Driver 12.4, incluez dans le classpath mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar.
Avec JDBC Driver 12.2, incluez dans le classpath mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar.
Si vous utilisez JDBC Driver 11.2, définissez le classpath pour inclure mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar.
Si vous utilisez JDBC Driver 10.2, définissez le classpath pour inclure mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.
Si vous utilisez JDBC Driver 9.4, définissez le classpath pour inclure mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.
Si vous utilisez JDBC Driver 9.2, définissez le classpath pour inclure mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.
Si vous utilisez JDBC Driver 8.4, définissez le classpath sur mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar.
Si vous utilisez le pilote JDBC 8.2, définissez le classpath sur mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar.
Avec JDBC Driver 7.4, incluez dans le mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar.
Avec JDBC Driver 7.2, incluez dans le classpath mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar.
Avec JDBC Driver 7.0, incluez dans le classpath mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar.
Avec JDBC Driver 6.4, incluez dans le classpath mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar.
Avec JDBC Driver 6.2, incluez dans le classpath mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar.
Avec JDBC Driver 4.1 ou 4.2, incluez respectivement dans le classpath le fichier sqljdbc41.jar ou le fichier sqljdbc42.jar provenant du téléchargement du pilote.
S’il manque une entrée correspondant au bon fichier JAR dans le classpath, l’application lève l’exception courante Class not found.
Pour Microsoft JDBC Driver 12.8
Les fichiers mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un pilote Microsoft JDBC Driver pour SQL Server, par exemple mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar.
Pour Microsoft JDBC Driver 12.6
Les fichiers mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un pilote Microsoft JDBC Driver pour SQL Server, par exemple mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.
Pour Microsoft JDBC Driver 12.4
Les fichiers mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un pilote Microsoft JDBC Driver pour SQL Server, par exemple mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar.
Pour Microsoft JDBC Driver 12.2
Les fichiers mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un pilote Microsoft JDBC Driver pour SQL Server, par exemple mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar.
Pour Microsoft JDBC Driver 11.2
Les fichiers mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre17.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-11.2.0.jre18.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un seul pilote Microsoft JDBC pour SQL Server, comme mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar.
Pour Microsoft JDBC Driver 10.2
Les fichiers mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-10.2.0.jre17.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar
Vérifiez que l’instruction CLASSPATH contient un seul Pilote Microsoft JDBC pour SQL Server, comme mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.
Pour Microsoft JDBC Driver 9.4
Les fichiers mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.4.1.jre16.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar
Vérifiez que l’instruction CLASSPATH contient un seul Pilote Microsoft JDBC pour SQL Server, comme mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.
Pour Microsoft JDBC Driver 9.2
Les fichiers mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-9.2.1.jre15.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar
Vérifiez que l’instruction CLASSPATH ne contient qu’un seul Pilote Microsoft JDBC pour SQL Server, comme mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.
Pour Microsoft JDBC Driver 8.4
Les fichiers mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.4.1.jre14.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar
Vérifiez que l’instruction CLASSPATH ne contient qu’un seul Pilote Microsoft JDBC pour SQL Server, par exemple mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar.
Pour Microsoft JDBC Driver 8.2
Les fichiers mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-8.2.2.jre13.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar
Vérifiez que l’instruction CLASSPATH ne contient qu’un seul Pilote Microsoft JDBC pour SQL Server, par exemple mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar.
Pour Microsoft JDBC Driver 7.4
Les fichiers mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre11.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.4.1.jre12.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un Pilote Microsoft JDBC pour SQL Server, par exemple mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar.
Pour Microsoft JDBC Driver 7.2
Les fichiers mssql-jdbc-7.2.2.jre8.jar ou mssql-jdbc-7.2.2.jre11.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar
L’instruction CLASSPATH ne doit contenir qu’un Pilote Microsoft JDBC pour SQL Server, par exemple soit mssql-jdbc-7.2.2.jre8.jar soit mssql-jdbc-7.2.2.jre11.jar.
Pour Microsoft JDBC Driver 7.0
Les fichiers mssql-jdbc-7.0.0.jre8.jar ou mssql-jdbc-7.0.0.jre10.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar
L’instruction CLASSPATH ne doit contenir qu’un Pilote Microsoft JDBC pour SQL Server, par exemple soit mssql-jdbc-7.0.0.jre8.jar soit mssql-jdbc-7.0.0.jre10.jar.
Pour Microsoft JDBC Driver 6.4
Les fichiers mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar et mssql-jdbc-6.4.0.jre9.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.4.0.jre9.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar
L’instruction CLASSPATH ne doit contenir qu’un seul pilote Microsoft JDBC pour SQL Server, par exemple mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar.
Pour Microsoft JDBC Driver 6.2
Les fichiers mssql-jdbc-6.2.2.jre7.jar ou mssql-jdbc-6.2.2.jre8.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar
L’instruction CLASSPATH ne doit contenir qu’un Pilote Microsoft JDBC pour SQL Server, par exemple soit mssql-jdbc-6.2.2.jre7.jar soit mssql-jdbc-6.2.2.jre8.jar.
Pour Microsoft JDBC Driver 4.1, 4.2 et 6.0
Les fichiers sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar et sqljdbc42.jar sont installés aux emplacements suivants :
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc4.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc41.jar
\<installation directory>\sqljdbc_<version>\<language>\sqljdbc42.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Windows :
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar
L’extrait de code suivant est un exemple de l’instruction CLASSPATH utilisée pour une application Unix/Linux :
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar
Vérifiez que l’instruction CLASSPATH contient un seul Pilote Microsoft JDBC pour SQL Server : sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar.
Notes
Sous Windows, les noms de répertoires d'une longueur supérieure à celle établie par la convention des noms de fichiers 8.3 ou les noms de dossiers contenant des espaces peuvent générer des problèmes avec les instructions classpath. Si vous pensez être confronté à ce type de problème, déplacez temporairement le fichier sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar dans un répertoire au nom simple tel que C:\Temp, modifiez l’instruction classpath et vérifiez si le problème est résolu.
Applications exécutées directement à l'invite de commandes
L'instruction classpath est configurée dans le système d'exploitation. Ajoutez sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar à l'instruction classpath du système. Vous pouvez également spécifier l’instruction classpath sur la ligne de commande Java qui exécute l’application avec l’option java -classpath.
Applications qui s'exécutent dans un IDE
Chaque fournisseur d’IDE fournit une méthode différente pour définir l’instruction classpath dans son IDE. La définition de l’instruction classpath dans le système d’exploitation ne fonctionne pas. Vous devez ajouter sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar à l'instruction classpath de l'IDE.
Servlets et JSP
Les servlets et les JSP sont exécutés dans un moteur de servlet/JSP tel que Tomcat. L'instruction classpath doit être définie conformément aux spécifications de la documentation relative au moteur de servlet/JSP. La définition de l’instruction classpath dans le système d’exploitation ne fonctionne pas. Certains moteurs de servlet/JSP affichent des écrans de configuration permettant de définir l'instruction classpath du moteur. Dans ce cas, vous devez ajouter le fichier JAR du pilote JDBC approprié à l'instruction classpath existante du moteur, puis redémarrer le moteur. Dans d'autres cas, vous pouvez déployer le pilote en copiant sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar dans un répertoire spécifique, tel que lib, pendant l'installation du moteur. Vous pouvez également spécifier l’instruction classpath du pilote de moteur dans un fichier de configuration spécifique au moteur.
EJB (Enterprise Java Beans)
Les EJB (Enterprise Java Beans) sont exécutés dans un conteneur EJB. Les conteneurs EJB proviennent de différents fournisseurs. Les applets Java s'exécutent dans un navigateur, mais sont téléchargés à partir d'un serveur web. Copiez le fichier sqljdbc.jar, sqljdbc4.jar ou sqljdbc41.jar à la racine du serveur web et spécifiez le nom du fichier JAR sous l’onglet d’archive HTML de l’applet, par exemple <applet ... archive=mssql-jdbc-***.jar>.
Créer une connexion simple à une base de données
Pour utiliser la bibliothèque de classes sqljdbc.jar, les applications doivent d’abord inscrire le pilote comme suit :
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
Une fois le pilote chargé, vous pouvez établir une connexion avec une URL de connexion et la méthode getConnection de la classe DriverManager :
String connectionUrl = "jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;encrypt=false;";
Connection con = DriverManager.getConnection(connectionUrl);
Avertissement
La chaîne de connexion ci-dessus utilise encrypt=false, ce qui n’est pas recommandé pour une utilisation en production. Pour plus d’informations sur le chiffrement de votre connexion de base de données avec JDBC, consultez Connexion avec le chiffrement.
À partir de l’API JDBC 4.0, la méthode DriverManager.getConnection() est améliorée pour charger automatiquement les pilotes JDBC. Par conséquent, les applications n’ont pas besoin d’appeler la méthode Class.forName pour inscrire ou charger le pilote lors de l’utilisation des bibliothèques jar des pilotes.
Lorsque la méthode getConnection de la classe DriverManager est appelée, un pilote correspondant est localisé parmi l’ensemble des pilotes JDBC inscrits. Le fichier sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar inclut le fichier « META-INF/services/java.sql.Driver », qui contient com.microsoft.sqlserver.jdbc.SQLServerDriver comme pilote inscrit. Les applications existantes, qui chargent actuellement les pilotes à l’aide de la méthode Class.forName, continueront de fonctionner sans modification.
Notes
Vous ne pouvez pas utiliser les bibliothèques de classe sqljdbc4.jar, sqljdbc41.jar et sqljdbc42.jar avec les anciennes versions de Java Runtime Environment (JRE). Pour obtenir la liste des versions de JRE prises en charge par Pilote Microsoft JDBC pour SQL Server, voir Configuration requise pour le pilote JDBC.
Pour savoir comment se connecter avec des sources de données et utiliser une URL de connexion, voir Créer l'URL de connexion et Définir les propriétés de connexion.