Utilisation du pilote JDBC

Télécharger le 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.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.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.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.

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);  

À 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.

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.

Voir aussi

Présentation du pilote JDBC