setPacketSize-Methode (SQLServerDataSource)

JDBC-Treiber herunterladen

Legt die aktuelle Netzwerkpaketgröße (in Bytes) für die Kommunikation mit SQL Server fest.

Syntax

  
public void setPacketSize(int packetSize)  

Parameter

packetSize

Ein Wert vom Typ int mit der Netzwerkpaketgröße.

Bemerkungen

Der akzeptable Wertebereich dieser Eigenschaft lautet "[-1 | 0 | 512..32767]". Wenn diese Eigenschaft auf einen Wert außerhalb des zulässigen Bereichs festgelegt wird, wird eine Ausnahme ausgelöst.

Die Anwendung versucht möglicherweise, die packetSize-Eigenschaft beim Herstellen einer Verbindung mit der Transport Layer Security (TLS) festzulegen, zuvor als Secure Sockets Layer-Verschlüsselung (SSL) bekannt. Die Paketgröße wird von Microsoft JDBC-Treiber für SQL Server mit dem Server ausgehandelt. Wenn die encrypt-Eigenschaft auf TRUE festgelegt ist und die ausgehandelte Paketgröße die TLS-Datensatzgröße des Standardsicherheitsanbieters der Java Virtual Machine-Instanz (JVM) übersteigt, wird vom Treiber ein Fehler ausgelöst, und die Verbindung wird getrennt.

Darüber hinaus wird von der Anwendung unter Umständen versucht, die packetSize-Eigenschaft ohne Anforderung der TLS-Verschlüsselung festzulegen. In diesem Fall gilt Folgendes: Wird vom Server vorausgesetzt, dass der Clientcomputer die TLS-Verschlüsselung unterstützt, wird vom Treiber die TLS-Datensatzgröße des Standardsicherheitsanbieters der JVM-Instanz überprüft. Übersteigt die packetSize-Eigenschaft die TLS-Datensatzgröße des Standardsicherheitsanbieters der Java Virtual Machine-Instanz (JVM), wird vom Treiber ein Fehler ausgelöst, und die Verbindung wird getrennt.

Weitere Informationen zur Verwendung von TLS finden Sie unter Verwenden von Verschlüsselung.

Weitere Informationen

SQLServerDataSource-Elemente
SQLServerDataSource-Klasse