| title | description | author | ms.author | ms.date | ms.service | ms.subservice | ms.topic | apilocation | apiname | apitype |
|---|---|---|---|---|---|---|---|---|---|---|
setPacketSize Method (SQLServerDataSource) |
setPacketSize Method (SQLServerDataSource) |
David-Engel |
v-davidengel |
01/19/2017 |
sql |
connectivity |
reference |
sqljdbc.jar |
SQLServerDataSource.setPacketSize |
Assembly |
[!INCLUDEDriver_JDBC_Download]
Sets the current network packet size used to communicate with [!INCLUDEssNoVersion], specified in bytes.
public void setPacketSize(int packetSize)
packetSize
An int value containing the network packet size.
The acceptable range of values of this property is [-1 | 0 | 512..32767]. If this property is set to a value outside the acceptable range, an exception will occur.
The application might want to set the packetSize property while connecting with Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), encryption. The [!INCLUDEjdbcNoVersion] negotiates the packet size with the server. If the encrypt property is set to "true" and the negotiated packet size is larger than the Java Virtual Machine (JVM)'s default security provider's TLS record size, the driver will raise an error and terminate the connection.
In addition, the application might want to set the packetSize property without requesting the TLS encryption. In this case, if the server requires the client to support TLS encryption, the driver checks the JVM's default security provider's TLS record size. If the packetSize property is larger than the JVM's default security provider's TLS record size, the driver will raise an error and terminate the connection.
For more information about using TLS, see Using encryption.