Verwenden des JDBC-Treibers
Dieser Abschnitt enthält Schnellstartanweisungen, um mit Microsoft JDBC-Treiber für SQL Server eine einfache Verbindung mit einer SQL Server-Datenbank herzustellen. Vor dem Herstellen einer Verbindung mit einer SQL Server-Datenbank müssen SQL Server auf dem lokalen Computer oder einem Server sowie der JDBC-Treiber auf dem lokalen Computer installiert werden.
Auswählen der richtigen JAR-Datei
Der Microsoft JDBC-Treiber bietet verschiedene JAR-Dateien, die in Verbindung mit Ihren bevorzugten Einstellungen für die Java Runtime Environment (JRE) verwendet werden können:
Der Microsoft JDBC-Treiber 12.8 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-12.8.0.jre8.jar und mssql-jdbc-12.8.0.jre11.jar bereit.
Der Microsoft JDBC-Treiber 12.6 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-12.6.0.jre8.jar und mssql-jdbc-12.6.0.jre11.jar bereit.
Der Microsoft JDBC-Treiber 12.4 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-12.4.0.jre8.jar und mssql-jdbc-12.4.0.jre11.jar bereit.
Der Microsoft JDBC-Treiber 12.2 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-12.2.0.jre8.jar und mssql-jdbc-12.2.0.jre11.jar.
Der Microsoft JDBC-Treiber 11.2 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar und mssql-jdbc-11.2.0.jre17.jar und mssql-jdbc-11.2.0.jre18.jar bereit.
Der Microsoft JDBC-Treiber 10.2 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar und mssql-jdbc-10.2.0.jre17.jar bereit.
Der Microsoft-JDBC-Treiber 9.4 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar und mssql-jdbc-9.4.1.jre16.jar bereit.
Der Microsoft JDBC-Treiber 9.2 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar und mssql-jdbc-9.2.1.jre15.jar bereit.
Der Microsoft JDBC-Treiber 8.4 für SQL Server stellt die Klassenbibliotheksdateien mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar und mssql-jdbc-8.4.1.jre14.jar bereit.
Der Microsoft JDBC-Treiber 8.2 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar und mssql-jdbc-8.2.2.jre13.jar.
Der Microsoft JDBC-Treiber 7.4 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar und mssql-jdbc-7.4.1.jre12.jar.
Der Microsoft JDBC-Treiber 7.2 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-7.2.2.jre8.jar und mssql-jdbc-7.2.2.jre11.jar.
Der Microsoft JDBC-Treiber 7.0 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-7.0.0.jre8.jar und mssql-jdbc-7.0.0.jre10.jar.
Der Microsoft JDBC-Treiber 6.4 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar und mssql-jdbc-6.4.0.jre9.jar.
Der Microsoft JDBC-Treiber 6.2 für SQL Server bietet die Klassenbibliotheksdateien mssql-jdbc-6.2.2.jre7.jar und mssql-jdbc-6.2.2.jre8.jar.
Die Microsoft JDBC-Treiber 6.0 und 4.2 für SQL Server bieten die Klassenbibliotheksdateien sqljdbc41.jar und sqljdbc42.jar.
Der Microsoft JDBC-Treiber 4.1 für SQL Server bietet die Klassenbibliotheksdatei sqljdbc41.jar.
Ihre Auswahl entscheidet über die verfügbaren Features. Weitere Informationen zum Auswählen der richtigen JAR-Datei finden Sie unter Systemanforderungen für den JDBC-Treiber.
Festlegen des Klassenpfads
Die JAR-Dateien des Microsoft JDBC-Treibers sind nicht Teil des Java SDK und müssen im Klassenpfad der Benutzeranwendung enthalten sein.
Wenn Sie den JDBC-Treiber 12.8 verwenden, richten Sie den Klassenpfad so ein, dass er mssql-jdbc-12.8.0.jre8.jar oder mssql-jdbc-12.8.0.jre11.jar enthält.
Wenn Sie den JDBC-Treiber 12.6 verwenden, richten Sie den Klassenpfad so ein, dass er mssql-jdbc-12.6.0.jre8.jar oder mssql-jdbc-12.6.0.jre11.jar enthält.
Wenn Sie den JDBC-Treiber 12.4 verwenden, richten Sie den Klassenpfad so einfest, dass er mssql-jdbc-12.4.0.jre8.jar oder mssql-jdbc-12.4.0.jre11.jar enthält.
Wenn Sie den JDBC-Treiber 12.2 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-12.2.0.jre8.jar oder mssql-jdbc-12.2.0.jre11.jar enthält.
Wenn Sie den JDBC-Treiber 11.2 verwenden, nehmen Sie die Datei mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar oder mssql-jdbc-11.2.0.jre17.jar oder mssql-jdbc-11.2.0.jre18.jar in den Klassenpfad auf.
Wenn Sie den JDBC-Treiber 10.2 verwenden, nehmen Sie die Datei mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar oder mssql-jdbc-10.2.0.jre17.jar in den Klassenpfad auf.
Wenn Sie den JDBC-Treiber 9.4 verwenden, nehmen Sie die Datei mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar oder mssql-jdbc-9.4.1.jre16.jar in den Klassenpfad auf.
Wenn Sie den JDBC-Treiber 9.2 verwenden, nehmen Sie die Datei mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar oder mssql-jdbc-9.2.1.jre15.jar in den Klassenpfad auf.
Wenn Sie den JDBC-Treiber 8.4 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar oder mssql-jdbc-8.4.1.jre14.jar enthält.
Wenn Sie den JDBC-Treiber 8.2 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar oder mssql-jdbc-8.2.2.jre13.jar enthält.
Wenn Sie den JDBC-Treiber 7.4 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar oder mssql-jdbc-7.4.1.jre12.jar enthält.
Wenn Sie JDBC-Treiber 7.2 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-7.2.2.jre8.jar oder mssql-jdbc-7.2.2.jre11.jar enthält.
Wenn Sie JDBC-Treiber 7.0 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-7.0.0.jre8.jar oder mssql-jdbc-7.0.0.jre10.jar enthält.
Wenn Sie den JDBC-Treiber 6.4 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar oder mssql-jdbc-6.4.0.jre9.jar enthält.
Wenn Sie JDBC-Treiber 6.2 verwenden, legen Sie fest, dass der Klassenpfad die Datei mssql-jdbc-6.2.2.jre7.jar oder mssql-jdbc-6.2.2.jre8.jar enthält.
Wenn Sie JDBC-Treiber 4.1 oder 4.2 verwenden, legen Sie fest, dass der Klassenpfad die Datei sqljdbc41.jar oder sqljdbc42.jar aus dem entsprechenden Treiberdownload enthält.
Wenn im Klassenpfad kein Eintrag für die richtige JAR-Datei vorhanden ist, löst eine Anwendung die allgemeine Ausnahme Class not found aus.
Für Microsoft JDBC-Treiber 12.8
Die Dateien mssql-jdbc-12.8.0.jre8.jar oder mssql-jdbc-12.8.0.jre11.jar werden an den folgenden Orten installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.8.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.8 for SQL Server\sqljdbc_12.8\enu\mssql-jdbc-12.8.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.8/enu/mssql-jdbc-12.8.0.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Datei des One Microsoft JDBC-Treibers für SQL Server enthält, z. B. entweder mssql-jdbc-12.8.0.jre8.jar oder mssql-jdbc-12.8.0.jre11.jar.
Für Microsoft JDBC-Treiber 12.6
Die Dateien mssql-jdbc-12.6.0.jre8.jar oder mssql-jdbc-12.6.0.jre11.jar werden an den folgenden Orten installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.6.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.6 for SQL Server\sqljdbc_12.6\enu\mssql-jdbc-12.6.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.6/enu/mssql-jdbc-12.6.0.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Datei des One Microsoft JDBC-Treibers für SQL Server enthält, z. B. entweder mssql-jdbc-12.6.0.jre8.jar oder mssql-jdbc-12.6.0.jre11.jar.
Für Microsoft JDBC-Treiber 12.4
Die Dateien mssql-jdbc-12.4.0.jre8.jar oder mssql-jdbc-12.4.0.jre11.jar werden in den folgenden Standorten installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.4.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.4 for SQL Server\sqljdbc_12.4\enu\mssql-jdbc-12.4.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.4/enu/mssql-jdbc-12.4.0.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Datei des Microsoft JDBC-Treibers für SQL Server enthält, z. B. entweder mssql-jdbc-12.4.0.jre8.jar oder mssql-jdbc-12.4.0.jre11.jar.
Für den Microsoft JDBC-Treiber 12.2
Die Dateien mssql-jdbc-12.2.0.jre8.jar und mssql-jdbc-12.2.0.jre11.jar werden in den folgenden Verzeichnissen installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-12.2.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 12.2 for SQL Server\sqljdbc_12.2\enu\mssql-jdbc-12.2.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_12.2/enu/mssql-jdbc-12.2.0.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Datei des Microsoft JDBC-Treibers für SQL Server enthält, z. B. entweder mssql-jdbc-12.2.0.jre8.jar oder mssql-jdbc-12.2.0.jre11.jar.
Für den Microsoft JDBC-Treiber 11.2
Die Dateien mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar oder mssql-jdbc-11.2.0.jre17.jar oder mssql-jdbc-11.2.0.jre18.jar werden an den folgenden Speicherorten installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 11.2 for SQL Server\sqljdbc_11.2\enu\mssql-jdbc-11.2.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_11.2/enu/mssql-jdbc-11.2.0.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z. B. entweder mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar oder mssql-jdbc-11.2.0.jre18.jar.
Für den Microsoft JDBC-Treiber 10.2
Die Dateien mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar oder mssql-jdbc-10.2.0.jre17.jar werden an den folgenden Speicherorten installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 10.2 for SQL Server\sqljdbc_10.2\enu\mssql-jdbc-10.2.0.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_10.2/enu/mssql-jdbc-10.2.0.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, also entweder mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar oder mssql-jdbc-10.2.0.jre17.jar.
Für den Microsoft JDBC-Treiber 9.4
Die Dateien mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar oder mssql-jdbc-9.4.1.jre16.jar werden an den folgenden Speicherorten installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.4 for SQL Server\sqljdbc_9.4\enu\mssql-jdbc-9.4.1.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.4/enu/mssql-jdbc-9.4.1.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, also entweder mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar oder mssql-jdbc-9.4.1.jre16.jar.
Für den Microsoft JDBC-Treiber 9.2
Die Dateien mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar oder mssql-jdbc-9.2.1.jre15.jar werden an den folgenden Speicherorten installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 9.2 for SQL Server\sqljdbc_9.2\enu\mssql-jdbc-9.2.1.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_9.2/enu/mssql-jdbc-9.2.1.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, also entweder mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar oder mssql-jdbc-9.2.1.jre15.jar.
Für Microsoft JDBC-Treiber 8.4
Die Dateien mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar oder mssql-jdbc-8.4.1.jre14.jar werden in den folgenden Verzeichnissen installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.4 for SQL Server\sqljdbc_8.4\enu\mssql-jdbc-8.4.1.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.4/enu/mssql-jdbc-8.4.1.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, also entweder mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar oder mssql-jdbc-8.4.1.jre14.jar.
Für Microsoft JDBC-Treiber 8.2
Die Dateien mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar und mssql-jdbc-8.2.2.jre13.jar werden unter den folgenden Verzeichnissen installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 8.2 for SQL Server\sqljdbc_8.2\enu\mssql-jdbc-8.2.2.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_8.2/enu/mssql-jdbc-8.2.2.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z. B. entweder mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar oder mssql-jdbc-8.2.2.jre13.jar.
Für Microsoft JDBC-Treiber 7.4
Die Datei mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar oder mssql-jdbc-7.4.1.jre12.jar wird im folgenden Verzeichnis installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.4 for SQL Server\sqljdbc_7.4\enu\mssql-jdbc-7.4.1.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z.B. entweder mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar oder mssql-jdbc-7.4.1.jre12.jar.
Für Microsoft JDBC-Treiber 7.2
Die Dateien mssql-jdbc-7.2.2.jre8.jar und mssql-jdbc-7.2.2.jre11.jar werden in den folgenden Verzeichnissen installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.2.2.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.2 for SQL Server\sqljdbc_7.2\enu\mssql-jdbc-7.2.2.jre11.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.2/enu/mssql-jdbc-7.2.2.jre11.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z. B. entweder mssql-jdbc-7.2.2.jre8.jar oder mssql-jdbc-7.2.2.jre11.jar.
Für Microsoft JDBC-Treiber 7.0
Die Dateien mssql-jdbc-7.0.0.jre8.jar und mssql-jdbc-7.0.0.jre10.jar werden in den folgenden Verzeichnissen installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre8.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-7.0.0.jre10.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 7.0 for SQL Server\sqljdbc_7.0\enu\mssql-jdbc-7.0.0.jre10.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_7.0/enu/mssql-jdbc-7.0.0.jre10.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z. B. entweder mssql-jdbc-7.0.0.jre8.jar oder mssql-jdbc-7.0.0.jre10.jar.
Für Microsoft JDBC-Treiber 6.4
Eine der Dateien mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar oder mssql-jdbc-6.4.0.jre9.jar wird im folgenden Verzeichnis installiert:
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.4 for SQL Server\sqljdbc_6.4\enu\mssql-jdbc-6.4.0.jre9.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.4/enu/mssql-jdbc-6.4.0.jre9.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z. B. entweder mssql-jdbc-6.4.0.jre7.jar oder mssql-jdbc-6.4.0.jre8.jar oder mssql-jdbc-6.4.0.jre9.jar.
Für Microsoft JDBC-Treiber 6.2
Die Dateien mssql-jdbc-6.2.2.jre7.jar und mssql-jdbc-6.2.2.jre8.jar werden in den folgenden Verzeichnissen installiert:
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre7.jar
\<installation directory>\sqljdbc_<version>\<language>\mssql-jdbc-6.2.2.jre8.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.2 for SQL Server\sqljdbc_6.2\enu\mssql-jdbc-6.2.2.jre8.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_6.2/enu/mssql-jdbc-6.2.2.jre8.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z. B. entweder „mssql-jdbc-6.2.2.jre7.jar“ oder „mssql-jdbc-6.2.2.jre8.jar“.
Für Microsoft JDBC-Treiber 4.1, 4.2 und 6.0
Die JAR-Datei sqljdbc.jar file, sqljdbc4.jar file, sqljdbc41.jar oder sqljdbc42.jar wird an folgendem Speicherorten installiert.
\<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
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Windows-Anwendung verwendet wird:
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 6.0 for SQL Server\sqljdbc_4.2\enu\sqljdbc42.jar
Der folgende Codeausschnitt stellt ein Beispiel für die CLASSPATH-Anweisung dar, die für eine Linux/Unix-Anwendung verwendet wird:
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.2/enu/sqljdbc42.jar
Stellen Sie sicher, dass die CLASSPATH-Anweisung nur eine Microsoft JDBC-Treiber für SQL Server-Datei enthält, z.B. „sqljdbc4.jar“, „sqljdbc41.jar“ oder „sqljdbc42.jar“.
Hinweis
Auf Windows-Systemen können Verzeichnisnamen, die länger als die 8.3-Namenskonvention sind, oder Ordnernamen mit Leerzeichen zu Problemen bei Klassenpfaden führen. Wenn Sie ein derartiges Problem vermuten, sollten Sie die Datei „sqljdbc.jar“, „sqljdbc4.jar“ oder „sqljdbc41.jar“ vorübergehend in ein Verzeichnis mit einem einfachen Namen wie C:\Temp verschieben, den Klassenpfad ändern und prüfen, ob das Problem dadurch behoben wurde.
Anwendungen, die direkt an der Eingabeaufforderung ausgeführt werden
Der Klassenpfad wird im Betriebssystem konfiguriert. Hängen Sie "sqljdbc.jar", "sqljdbc4.jar" oder "sqljdbc41.jar" an den Klassenpfad des Systems an. Alternativ können Sie den Klassenpfad in der Java-Befehlszeile, mit der die Anwendung ausgeführt wird, mit der Option java -classpath angeben.
Anwendungen, die in einer IDE ausgeführt werden
Jeder IDE-Anbieter stellt eine andere Methode zum Festlegen des Klassenpfads in seiner IDE bereit. Das Festlegen des Klassenpfads im Betriebssystem funktioniert nicht. Sie müssen "sqljdbc.jar", "sqljdbc4.jar" oder "sqljdbc41.jar" an den IDE-Klassenpfad anhängen.
Servlets und JSPs
Servlets und JSPs werden in einer Servlet-/JSP-Engine wie Tomcat ausgeführt. Der Klassenpfad muss wie in der Dokumentation für die Servlet-/JSP-Engine angegeben festgelegt werden. Das Festlegen des Klassenpfads im Betriebssystem funktioniert nicht. Einige Servlet-/JSP-Engines verfügen über Setupfenster, in denen Sie den Klassenpfad der Engine festlegen können. In dieser Situation müssen Sie die richtige JAR-Datei für den JDBC-Treiber an den vorhandenen Klassenpfad der Engine anhängen und die Engine neu starten. In anderen Situationen können Sie den Treiber bereitstellen, indem Sie "sqljdbc.jar", "sqljdbc4.jar" oder "sqljdbc41.jar" bei der Engine-Installation in ein bestimmtes Verzeichnis kopieren, z. B. "lib". Der Klassenpfad für den Engine-Treiber kann auch in einer Engine-spezifischen Konfigurationsdatei angegeben werden.
Enterprise Java Beans
Enterprise Java Beans (EJB) werden in einem EJB-Container ausgeführt. EJB-Container sind von verschiedenen Herstellern erhältlich. Java-Applets werden in einem Browser ausgeführt, aber von einem Webserver heruntergeladen. Kopieren Sie „sqljdbc.jar“ „sqljdbc4.jar“ oder „sqljdbc41.jar“ in das Stammverzeichnis des Webservers, und geben Sie den Namen der JAR-Datei auf der HTML-Archiv-Registerkarte des Applets an, z.B. <applet ... archive=mssql-jdbc-***.jar>.
Herstellen einer einfachen Verbindung mit einer Datenbank
Um die Klassenbibliothek „sqljdbc.jar“ zu verwenden, müssen Anwendungen zuerst den Treiber wie folgt registrieren:
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
Nachdem der Treiber geladen wurde, können Sie über eine Verbindungs-URL und die getConnection-Methode der DriverManager-Klasse eine Verbindung herstellen:
String connectionUrl = "jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=<password>;encrypt=false;";
Connection con = DriverManager.getConnection(connectionUrl);
Warnung
In der obigen Verbindungszeichenfolge wird encrypt=false verwendet. Dies wird für Produktionsumgebungen nicht empfohlen. Weitere Informationen zum Verschlüsseln Ihrer Datenbankverbindung mit JDBC finden Sie unter Herstellen von Verbindungen mit einer Verschlüsselung.
Ab der JDBC-API 4.0 wurde die DriverManager.getConnection()-Methode so erweitert, dass JDBC-Treiber automatisch geladen werden. Daher müssen Anwendungen die Class.forName-Methode bei Verwendung von JAR-Treiberbibliotheken nicht aufrufen, um den Treiber zu registrieren oder zu laden.
Wenn die getConnection-Methode der DriverManager-Klasse aufgerufen wird, wird aus der Gruppe der registrierten JDBC-Treiber ein geeigneter Treiber ausgewählt. „sqljdbc4.jar“, „sqljdbc41.jar“ und „sqljdbc42.jar“ enthalten die Datei „META-INF/services/java.sql.Driver“, die den com.microsoft.sqlserver.jdbc.SQLServerDriver als registrierten Treiber enthält. Vorhandene Anwendungen, die die Treiber derzeit mit der Methode Class.forName laden, funktionieren auch weiterhin ohne Änderungen.
Hinweis
Die Klassenbibliothek „sqljdbc4.jar“, „sqljdbc41.jar“ oder „sqljdbc42.jar“ kann nicht mit älteren Versionen von Java Runtime Environment (JRE) verwendet werden. Die Liste der vom Microsoft JDBC-Treiber für SQL Server unterstützten JRE-Versionen finden Sie unter Systemanforderungen für den JDBC-Treiber.
Weitere Informationen zum Herstellen einer Verbindung mit Datenquellen und zum Verwenden einer Verbindungs-URL finden Sie unter Erstellen der Verbindungs-URL und Festlegen der Verbindungseigenschaften.