Timeout-Eigenschaften im JDBC-Treiber verstehen

JDBC-Treiber herunterladen

Timeouteinstellungen im JDBC-Treiber können verwendet werden, um die Reaktionsfähigkeit der Anwendung zu priorisieren. Standardmäßig priorisieren die meisten Timeouts des Treibers das Warten auf ein Ergebnis, um die Datenkonsistenz sicherzustellen. Stellen Sie sicher, dass Sie Timeouts auswählen, die den Anforderungen Ihrer Anwendung entsprechen.

Für die erste Verbindung wird loginTimeout verwendet:

• loginTimeout ist die Anzahl der Sekunden, die der Treiber wartet, um eine Verbindung zum Server herzustellen. Wenn diese Zeit vergeht, gibt der Treiber eine Fehlermeldung zurück und stellt keine Verbindung her. Ein Wert von null setzt den Timeout auf den Standard-System-Timeout, der in JDBC-Treiber 11.2 und neueren Versionen 30 Sekunden beträgt. In JDBC-Treiber 10.2 und früheren Versionen beträgt die Standard-Timeout 15 Sekunden. Jeder Wert ungleich null legt die Anzahl der Sekunden fest, die der Treiber wartet, bevor für eine fehlgeschlagene Verbindung ein Timeout ausgelöst wird. Wenn Sie ständig Schwierigkeiten haben, eine Verbindung mit dem JDBC-Treiber herzustellen, müssen Sie diese Zeitzeit möglicherweise auf 90 oder sogar 120 Sekunden erhöhen. loginTimeout begrenzt auch die Verbindungsversuche des Treibers, nicht nur einen einzigen Versuch, was wichtig ist, wenn man sich mit einer automatisch angehaltenen serverlosen Azure SQL-Datenbank verbindet. Weitere Informationen finden Sie unter Verbinden mit einer automatisch pausierten serverlosen Datenbank.

Sobald die Verbindung hergestellt wurde, werden queryTimeout, cancelQueryTimeout und lockTimeout während der Anweisungsausführungen verwendet. socketTimeout wird für jegliche Treiberkommunikation mit dem Server verwendet.

• queryTimeout ist die Zeit in Sekunden, die der Treiber wartet, nachdem er einen Ausführungsbefehl an den Server gesendet hat, um eine Antwort vom Server mit Daten zu erhalten. Wenn diese Zeit überschritten wird, wird der Befehl abgebrochen. Das Überschreiten dieses Timeouts schließt die Verbindung nicht. Der Standardwert lautet „-1“, d. h. ein unendliches Timeout.
• cancelQueryTimeout ist die Zeit in Sekunden, die der Treiber auf eine Bestätigung des queryTimeout-Abbruchs vom Server wartet, bevor er die Verbindung gewaltsam beendet/schließt. Das heißt, der Treiber wartet insgesamt cancelQueryTimeout plus queryTimeout Sekunden, bevor die Verbindung geschlossen wird. Durch Festlegen dieses Timeouts auf einen Wert ungleich 0 wird sichergestellt, dass Anwendungen reaktionsfähig bleiben können, wenn ein Netzwerk- oder Kommunikationsfehler mit dem Server auftritt und ein Timeout für eine Abfrage aufgetreten ist. Der Standardwert für diese Eigenschaft ist -1, was einer unendlichen Wartezeit entspricht.
• lockTimeout ist die Zeitspanne, die auf die Freigabe einer Sperre gewartet wird, wenn eine Sperre die Ausführung einer Anweisung blockiert. Das Überschreiten dieses Timeouts führt nicht zu einer geschlossenen Verbindung. Der Standardwert für diese Eigenschaft ist -1, was einer unendlichen Wartezeit entspricht.
• socketTimeout gilt für die gesamte Socketkommunikation mit dem Server. Wenn der Server die Kommunikation mit dem Treiber beendet, indem er Daten nicht bestätigt oder antwortet, wartet der Treiber auf den Wert von socketTimeout, bevor er die Verbindung schließt. Durch Festlegen dieses Timeouts auf einen Wert ungleich 0 wird sichergestellt, dass Anwendungen reagieren können, wenn ein Netzwerk- oder Kommunikationsfehler mit dem Server auftritt. Der Standardwert ist 0, d. h. ein unendliches Timeout. Stellen Sie sicher, dass socketTimeout größer als queryTimeout ist, um Socket-Timeoutausnahmen während des Zeitfensters queryTimeout zu vermeiden. Ebenso müssen Sie sicherstellen, dass socketTimeout größer als cancelQueryTimeout ist, um Socket-Timeout-Ausnahmen während des cancelQueryTimeout-Fensters zu vermeiden.

Angemessene Timeoutwerte für Ihre Anwendung hängen von den Prioritäten der Anwendung ab. Das Festlegen niedrigerer Werte für Timeouts priorisiert die Reaktionsfähigkeit der Anwendung gegenüber der Datenkonsistenz. Wenn Timeouts erreicht werden, müssen Anwendungen entscheiden, welche Vorgehensweise am besten ist. Diese Entscheidung basiert auf der ausgeführten Datenbankaktion. Zum Beispiel könnte bei einer SELECT-Anweisung entschieden werden, dem Benutzer einen Fehler anzuzeigen, oder die Verbindung wiederherzustellen und den Vorgang zu wiederholen. Für INSERT oder UPDATE Aussagen könnte diese Entscheidung anders ausfallen.

Für eine reaktionsfähige Anwendung sollten loginTimeout und queryTimeout auf relativ niedrige Werte festgelegt werden. Ebenso sollte auch cancelQueryTimeout auf einen niedrigen Wert festgelegt werden, um sicherzustellen, dass der Treiber nicht zu lange wartet, bis der Server den Abbruch der Abfrage bestätigt, wenn ein queryTimeout überschritten wird. Schließlich sollte socketTimeout so festgelegt werden, dass der Treiber während eines Szenarios, in dem die Verbindung mit dem Server unterbrochen ist (Netzwerkunterbrechung, Serverabsturz usw.), nicht zu lange wartet.

Eigenschaftenzusammenfassung

Verwandte Inhalte

• Festlegen der Verbindungseigenschaften