API-Referenz für den JDBC-Treiber
Übersicht
Die vom Microsoft-JDBC-Treiber für SQL Server bereitgestellte API kann innerhalb von Java-Programmiercode zum Herstellen einer Verbindung und zum Kommunizieren mit einer Microsoft SQL Server-Datenbank verwendet werden.
„JavaDoc.io“ ist primäre Website
Die API-Referenzdokumentation für Microsoft JDBC wird zur Anzeige auf der Website „JavaDoc.io“ gehostet. „JavaDoc.io“ ist jetzt die primäre Website für die JDBC-Referenzdokumentation. Die JDBC-Referenzdokumentation auf „JavaDoc.io“ ist unter folgendem Direktlink verfügbar:
„JavaDoc.io“ enthält die JDBC-Referenzdokumentation ab Version 6.0.
Hier nur ältere JDBC-Dokumentation
Die JDBC-API-Referenzdokumentation auf dieser Website wird nicht mehr aktualisiert. Die hier enthaltenen Artikel umfassen jedoch die gesamte Referenz für die JDBC-Treiberversionen 4.1 und 4.2.
Die Dokumentation für die JDBC-Treiberversion 6.0 und einige spätere Versionen befindet sich ebenfalls hier. Für alle Versionen ab 6.0 verwenden Sie bitte die Website JavaDoc.io.
Wichtige Hinweise
Hinweis
Konzeptionelle Informationen zur Verwendung des JDBC-Treibers finden Sie unter Übersicht über den JDBC-Treiber.
Wichtig
Verwenden Sie den Microsoft JDBC-Treiber 4.2 (oder höher) für SQL Server, um JDBC 4.1- und 4.2-Kompatibilität zu unterstützen. Die vorhergehenden Versionen der Microsoft JDBC-Treiber 4.1 und 4.0 unterstützen die in JDBC 4.1 und 4.2 eingeführten neuen Methoden nicht.
API-Details zur JDBC 4.1-Kompatibilität werden in diesem Abschnitt nicht erörtert. Weitere Informationen finden Sie unter JDBC 4.1-Kompatibilität für den JDBC-Treiber.
API-Details zur JDBC 4.2-Kompatibilität werden in diesem Abschnitt nicht erörtert. Weitere Informationen finden Sie unter JDBC 4.2-Kompatibilität für den JDBC-Treiber.
API-Details zur Massenkopierfunktion, die im Microsoft JDBC-Treiber 4.2 für SQL Server zur Verfügung steht, werden in diesem Abschnitt nicht erörtert. Weitere Informationen finden Sie unter Verwenden von Massenkopieren mit dem JDBC Driver.
API-Details für das Feature „Always Encrypted“, das ab dem Microsoft JDBC-Treiber 6.0 für SQL Server verfügbar ist, werden in diesem Abschnitt nicht erläutert. Weitere Informationen finden Sie unter Always Encrypted – API-Referenz für den JDBC-Treiber.
API-Details für das Verwenden von Tabellenwertparametern, das ab dem Microsoft JDBC-Treiber 6.0 für SQL Server verfügbar ist, sind in diesem Abschnitt nicht enthalten. Weitere Informationen finden Sie unter Verwenden von Tabellenwertparametern.
Microsoft FABRIC Driver 12.2 und höher unterstützt die Kompilierung mit JDK 8.0 und allen Java-Versionen 11.0 und höher.
Microsoft DRIVER 11.2 unterstützt die Kompilierung mit JDK 8.0, 11.0, 17.0 und 18.0.
Microsoft DRIVER 10.2 unterstützt die Kompilierung mit JDK 8.0, 11.0 und 17.0.
Microsoft ASPX Driver 9.4 unterstützt die Kompilierung mit JDK 8.0, 11.0 und 16.0.
Microsoft CONSOLE Driver 9.2 unterstützt die Kompilierung mit JDK 8.0, 11.0 und 15.0.
Microsoft ASPX Driver 8.4 unterstützt die Kompilierung mit JDK 8.0, 11.0 und 14.0.
Microsoft ASPX Driver 8.2 unterstützt die Kompilierung mit JDK 8.0, 11.0 und 13.0.
Microsoft ASPX-Treiber 7.4 unterstützt die Kompilierung mit JDK 8.0, 11.0 und 12.0.
Microsoft DRIVER 7.2 unterstützt die Kompilierung mit JDK 8.0 und 11.0.
Microsoft DRIVER 7.0 unterstützt die Kompilierung mit JDK 8.0 und 10.0.
Der Microsoft JDBC-Treiber 6.4 unterstützt die Kompilierung mit JDK 7.0, 8.0 und 9.0.
Der Microsoft JDBC-Treiber 6.2 unterstützt die Kompilierung mit JDK 7.0 und 8.0.
Die Microsoft JDBC-Treiber 6.0 und 4.2 unterstützen die Kompilierung mit JDK 5.0, 6.0, 7.0 und 8.0.
Der Microsoft JDBC-Treiber 4.1 unterstützt die Kompilierung mit JDK 5.0, 6.0 und 7.0.
Schnittstellen
| Schnittstellenname | BESCHREIBUNG |
|---|---|
| ISQLServerCallableStatement-Schnittstelle | Mit dieser Klasse kann der gespeicherte Prozedurname angegeben werden, der mit Eingabe- und Ausgabeparametern aufgerufen wird. |
| ISQLServerConnection-Schnittstelle | Stellt eine JDBC-Verbindung mit einer SQL Server-Datenbank dar. |
| SQLServerDataSource-Klasse | Stellt eine Liste mit spezifischen Eigenschaften für das Herstellen einer Verbindung mit einer SQL Server-Datenbank (unter Verwendung eines ISQLServerConnection-Objekts) dar. |
| ISQLServerPreparedStatement | Stellt die grundlegende Implementierung der JDBC-Funktion für vorbereitete Anweisungen dar. |
| ISQLServerResultSet | Stellt ein JDBC-Resultset dar. |
| ISQLServerStatement | Stellt die grundlegende Implementierung der JDBC-Anweisungsfunktion dar. |
Klassen
| Klassenname | BESCHREIBUNG |
|---|---|
| DateTimeOffset | Stellt ein Objekt vom Typ "microsoft.sql.DateTimeOffset" dar. |
| SQLServerBlob | Stellt ein BLOB (Binary Large Object) dar. |
| SQLServerCallableStatement | Implementiert ISQLServerCallableStatement. |
| SQLServerClob | Stellt ein CLOB (Character Large Binary Object) dar. |
| SQLServerConnection | Implementiert ISQLServerConnectopn. |
| SQLServerConnectionPoolDataSource | Stellt die physischen Datenbankverbindungen für Verbindungspool-Manager dar. |
| SQLServerDatabaseMetaData | Stellt die Metadaten für die Datenbank dar. |
| SQLServerDataSource | Stellt eine Liste mit spezifischen Eigenschaften für das Herstellen einer Verbindung mit einer SQL Server-Datenbank (unter Verwendung eines SQLServerConnection-Objekts) dar. |
| SQLServerDataSourceObjectFactory | Stellt ein Objektfactory zum Materialisieren von Datenquellen aus der JNDI (Java Naming and Directory Interface) dar. |
| SQLServerDriver | Stellt den JDBC-Treiber dar. Diese Klasse enthält Methoden zum Herstellen einer Verbindung mit einer SQL Server-Datenbank sowie zum Abrufen von Informationen zum JDBC-Treiber. |
| SQLServerException | Stell die fehlerhafte oder unvollständige Ausführung einer SQL-Anweisung dar. |
| SQLServerNClob-Klasse | Stellt ein CLOB (Character Large Binary Object) mit nationalem Zeichensatz dar. |
| SQLServerParameterMetaData | Stellt die Metadaten für die Parameter vorbereiteter Anweisungen dar. |
| SQLServerPooledConnection | Stellt eine physische Datenbankverbindung in einem Verbindungspool dar. |
| SQLServerPreparedStatement | Implementiert ISQLServerPreparedStatement. |
| SQLServerResource | Stellt eine Ressource für lokalisierte Fehlerzeichenfolgen dar. Diese Klasse dient nur zur internen Verwendung. |
| SQLServerResultSet | Implementiert ISQLServerResultSet. |
| SQLServerResultSetMetaData | Stellt die Metadaten der Spalten innerhalb eines Resultsets dar. |
| SQLServerSavepoint | Stellt den Prüfpunkt dar, bis zu dem ein Transaktionsrollback durchgeführt werden kann. |
| SQLServerStatement | Implementiert ISQLServerStatement. |
| SQLServerXAConnection | Stellt JDBC-Verbindungen dar, die an verteilten Transaktionen (XA-Transaktionen) beteiligt sein können. |
| SQLServerXADataSource | Stellt eine intern verwendete Factory für SQLServerXAConnection-Objekte dar. |
| SQLServerXAResource | Stellt ein XAResource-Objekt für die Verwaltung verteilter XA-Transaktionen dar. |