Microsoft JDBC-Treiber für SQL Server

JDBC-Treiber herunterladen

Der Microsoft Java Database Connectivity (DATABASE Connectivity) DRIVER for SQL Server ist ein Type 4 DRIVER (pure Java, spricht das SQL Server TDS-Protokoll direkt, keine nativen Bibliotheken), mit denen Java Anwendungs- oder Anwendungsserver mit SQL Server verbunden werden können, Azure SQL-Datenbank, Azure SQL Managed Instance und SQL-Datenbank in Microsoft Fabric. Er implementiert die STANDARD-AUFGABEN-APIs UND arbeitet mit wichtigen Java Anwendungsservern, darunter IBM WebSphere und SAP NetWeaver.

Auswählen des Startpunkts

• Um eine Java Entwicklungsumgebung einzurichten und Ihre erste Abfrage auszuführen, beginnen Sie mit Schritt 1: Konfigurieren der Entwicklungsumgebung, Schritt 2: Erstellen einer SQL-Datenbank und Schritt 3: Machbarkeitsstudie für die Verbindung mit SQL mithilfe von Java.
• Um eine Verbindung mit Azure SQL mit kennwortloser Authentifizierung herzustellen, beginnen Sie mit Connect mithilfe Microsoft Entra Authentifizierung und Erstellen der Verbindungs-URL.
• Wenn Sie den Treiber einem Maven-, Gradle- oder anderen Build hinzufügen möchten, wechseln Sie zum Download Microsoft DRIVER FÜR SQL Server.
• Um eine vorhandene App anfällig für vorübergehende Fehler zu machen, wechseln Sie zu Verbindungsresilienz und konfigurierbarer Wiederholungslogik.
• Um ein Verbindungs- oder Abfrageproblem zu diagnostizieren, wechseln Sie zur Diagnose von Problemen mit dem ELEMENTTREIBER UNDzur Problembehandlung bei der Konnektivität.

Produktionsbasisplan für Azure SQL

Verwenden Sie diesen Codeausschnitt als Ausgangspunkt für eine produktionsorientierte Azure SQL Verbindung. Er lädt den Servernamen und den Datenbanknamen aus der Anwendungskonfiguration, z. B. Azure App Service App-Einstellungen, Umgebungsvariablen oder eine Konfigurationsdatei, und legt die restlichen Verbindungseigenschaften programmgesteuert fest. Die Konfiguration kombiniert Transport Layer Security (TLS), verwaltete Identität, Verbindungswiederholungen bei vorübergehenden Fehlern, schnelle Failovergruppenwiederherstellung, ein längeres Anmeldetimeout, um ein Kaltstart-Failover abzudecken, und konfigurierbare Wiederholungslogik (Retry Logic, CRL) für Anweisungen, die Azure SQL Drosselung oder Mid-Query-Failover getroffen haben.

Um eine höhere Sicherheit und eine einfachere Skalierung zu gewährleisten, behalten Sie Verbindungsinformationen außerhalb Des Codes bei. Speichern Sie in der Produktion Verbindungsinformationen im Konfigurationssystem Ihrer Anwendung, und verwenden Sie Azure Key Vault für vertrauliche Werte und zentral verwaltete Verbindungseinstellungen. Weitere Informationen finden Sie unter Sichern von Verbindungszeichenfolgen.

Die Java Codeausschnitte in diesem Artikel lassen Importe und Klassenwrapper aus Platzgründen weg.

// Load endpoint details from application configuration. In Azure App Service,
// these can come from app settings or Key Vault-backed settings.
String serverName = System.getenv("SQL_SERVER_NAME");
String databaseName = System.getenv("SQL_DATABASE_NAME");
String port = System.getenv().getOrDefault("SQL_PORT", "1433");

if (serverName == null || databaseName == null) {
    throw new IllegalStateException(
            "Set SQL_SERVER_NAME and SQL_DATABASE_NAME in your application configuration.");
}

String url = "jdbc:sqlserver://" + serverName + ":" + port;

Properties props = new Properties();
props.setProperty("databaseName", databaseName);
props.setProperty("encrypt", "true");
props.setProperty("trustServerCertificate", "false");
props.setProperty("authentication", "ActiveDirectoryManagedIdentity");
props.setProperty("loginTimeout", "120");         // 90 is the minimum floor for this retry profile; 120 leaves practical failover margin
props.setProperty("connectRetryCount", "5");     // retry transient connection failures up to 5 times (default 1)
props.setProperty("connectRetryInterval", "15"); // 15 seconds between connection retries (default 10)
props.setProperty("multiSubnetFailover", "true"); // recommended for any Azure SQL HA listener
// props.setProperty("applicationIntent", "ReadOnly"); // uncomment to route to a readable secondary
// Retry deadlocks and lock timeouts, plus Azure SQL throttling and mid-query failover.
props.setProperty("retryExec", "1205,1222:3,5+5;40501,40613,40197,10928,10929,49918:4,5*2");

try (Connection conn = DriverManager.getConnection(url, props);
     Statement stmt = conn.createStatement();
     ResultSet rs = stmt.executeQuery("SELECT 1")) {
    while (rs.next()) {
        System.out.println(rs.getInt(1));
    }
}

Dieser Codeausschnitt ist für Azure SQL-Datenbank Failovergruppen und Azure SQL Managed Instance optimiert.

Wird nur festgelegt multiSubnetFailover=true , wenn Sie eine Verbindung mit einem Failovergruppenlistener, verfügbarkeitsgruppenlistener oder Failoverclusterinstanzenendpunkt herstellen. Die Verwendung dieser Eigenschaft für Endpunkte, die keine HA-Listener (High Availability) sind, können die Leistung beeinträchtigen und werden nicht unterstützt. Weitere Informationen finden Sie unter TREIBERunterstützung für hohe Verfügbarkeit, Notfallwiederherstellung.

Der Codeausschnitt wird nicht festgelegtretryConn, da der Treiber bereits die häufigsten Azure SQL vorübergehenden Verbindungsfehler (einschließlich 4060, 40197, 40501, 40613, 49918, 49919, 49920, 10928 und 10929) außerhalb der Box, toriert von connectRetryCount und connectRetryInterval. Die vollständige Liste finden Sie in der Liste der integrierten vorübergehenden Verbindungsfehler. Fügen Sie retryConn nur hinzu +<errorNumber> , wenn Sie die Liste mit einem Fehler erweitern müssen, der noch nicht abgedeckt ist, oder legen Sie sie auf <errorNumber> (keine Führende +) fest, um sie zu ersetzen. Wenn Sie denselben Wert in einer URL DER DATEI ANGEBEN, umschließen Sie ihn wie retryConn={+<errorNumber>} oder retryConn={<errorNumber>}.

Die retryExec Eigenschaft verfügt über zwei Teile, die wie rule1;rule2 beim programmgesteuerten Festlegen geschrieben werden. Wenn Sie denselben Wert in einer URL DER DATEI ANGEBEN, schließen Sie jede Regel in geschweifte Klammern um:{rule1};{rule2}

• {1205,1222:3,5+5} Wiederholt Deadlock-Opfer (1205) und Sperranforderungstimeouts (1222) dreimal mit einem linearen Backoff von 5, 10 und 15 Sekunden. Für 1205 setzt SQL Server die Transaktion zurück, bevor der Treiber den Fehler sieht. Daher ist das erneute Ausführen einer einzelnen Anweisung sicher. Wenn die Deadlocked-Anweisung Teil einer Multistatement-Transaktion war, wurden frühere Anweisungen ebenfalls zurückgesetzt, und CRL gibt sie nicht wieder, sodass die gesamte Transaktion in Ihrer eigenen Wiederholungsschleife eingeschlossen wird. 1222 lässt die Transaktion geöffnet, und der Wiederholungsversuche auf Anweisungsebene führen nur die Anweisung innerhalb der ursprünglichen Transaktion erneut aus. Wenn Sie auch die Transaktionsdauer binden müssen, schließen Sie die gesamte Transaktion in Ihre eigene Wiederholungsschleife um.

• {40501,40613,40197,10928,10929,49918:4,5*2}Wiederholt Azure SQL Drosselung, Mid-Query-Failover und Ressourcenlimitfehler viermal mit exponentiellem Backoff von 5, 10, 20 und 40 Sekunden. Diese Fehler befinden sich in der integrierten vorübergehenden Liste für die Verbindungsschleife , aber sie werden abgefangen, retryExec wenn sie mid-query gegen eine hergestellte Verbindung auslösen. CRL-Backoffs sind an queryTimeout. Wenn Sie niedriger als die nächste geplante Wartezeit festlegen queryTimeout , gibt der Fahrer früh auf und erniedrigend. Wählen Sie ein queryTimeout , das mindestens so groß ist, wie die Summe Der CRL wartet plus Anweisungslaufzeit, oder akzeptieren Sie, dass die längsten Backoffs nicht ausgelöst werden.

Bei Azure SQL-Datenbank Failovergruppen legen Hyperscale benannte Replikate und Leseskalenlistener oder AlwaysOn-Verfügbarkeitsgruppenlistener festapplicationIntent=ReadOnly, wenn Sie zu einer lesbaren sekundären Gruppe gelangen möchten. Für souveräne Clouds, bei denen der alternative Antragstellername (Subject Alternative Name, SAN) nicht den Host enthält, mit dem Sie eine Verbindung herstellen, ist auch auf Übereinstimmung festgelegt hostNameInCertificate (z*.database.usgovcloudapi.net. B. für Azure Government).

Weitere Informationen zu den einzelnen Teilen dieser Konfiguration finden Sie unter:

• Erstellen der Verbindungs-URL
• Festlegen der Verbindungseigenschaften
• Herstellen einer Verbindung mit der Microsoft Entra-Authentifizierung
• Verbindungsresilienz
• Konfigurierbare Wiederholungslogik
• JDBC-Treiber-Unterstützung für hohe Verfügbarkeit, Notfallwiederherstellung
• Grundlegendes zu Timeouteigenschaften im ELEMENTTREIBER

Informationen zum Katalog mit Azure SQL vorübergehenden Fehlern finden Sie unter Problembehandlung bei vorübergehenden Verbindungsfehlern.

Wichtigste Funktionen

• Standardbasiertes BENCHMARKING: Typ 4 Treiber. Der JRE 11+-Build implementiert SHAPE 4.2 plus die REQUEST-Boundary-Methoden (beginRequest, endRequest) und Statement zitierende Helfer. FEATURES 4.3 sharding APIs (setShardingKey, die createConnectionBuilder Familie) werfen SQLFeatureNotSupportedException. Der JRE 8 Build implementiert BUILDS 4.2. Die Aufschlüsselung pro Version und die vollständige Liste der unterstützten und nicht unterstützten 4.3-Methoden finden Sie unter Java- und VORGANGSspezifikationsunterstützung.
• Breite Plattformunterstützung: Läuft auf jeder Plattform mit einem unterstützten Java Virtual Machine (JVM), einschließlich Windows, Linux und macOS.
• Standardmäßig verschlüsselt: TLS-verschlüsselte Verbindungen encrypt=true als Standard für aktuelle Treiber.
• Microsoft Entra ID Authentifizierung: Kennwortlose Verbindungen mit verwalteter Identität, Dienstprinzipal, interaktiv, integriert, Standardanmeldeinformationskette und Zugriffstokenflüssen.
• Kerberos: Integrierte Authentifizierung für lokales Active Directory.
• NTLM: Windows Abfrage-/Antwortauthentifizierung für Nichtdomänen- oder Legacyszenarien.
• Immer verschlüsselt: Clientseitige Verschlüsselung für vertrauliche Spalten mit optionalen sicheren Enklaven für direkte Vorgänge.
• Massenkopie: Fügt einen hohen Durchsatz mit der API und der SQLServerBulkCopy Leistung für Batcheinfügungen für executeBatch.
• Verbindungsresilienz: Integrierte Verbindungsversuche für vorübergehende Fehler sowie konfigurierbare Wiederholungslogik für Anweisungen (retryExec) und eine anpassbare Verbindungsfehlerliste (retryConn).
• Umfassende SQL Server Datentypunterstützung: datetimeoffset, sql_variant, JSON, spatial, vector, table-valued parameters, and user-defined types.

Get started

Konfigurieren und Verbinden

Authenticate

Absichern

Mit Daten arbeiten

Datentypen

Transaktionen und Parallelität

Leistung und Zuverlässigkeit

Diagnostizieren und Problembehandlung

Verwandte Aufgaben

Zugehöriger Inhalt

• MICROSOFT TREIBER FÜR SQL Server auf GitHub
• Microsoft DRIVER für SQL Server auf Maven Central
• Versionshinweise für den MICROSOFT TREIBER FÜR SQL Server
• Suchen von zusätzlichen Informationen zum JDBC-Treiber
• Verbindungsmodule für microsoft SQL-Datenbank