setPacketSize メソッド (SQLServerDataSource)setPacketSize Method (SQLServerDataSource)

ダウンロードJDBC Driver のダウンロードDownloadDownload JDBC Driver

SQL ServerSQL Server との通信に使用される現在のネットワーク パケット サイズが設定されます (バイトで指定します)。Sets the current network packet size used to communicate with SQL ServerSQL Server, specified in bytes.

構文Syntax

  
public void setPacketSize(int packetSize)  

パラメーターParameters

packetSizepacketSize

ネットワーク パケット サイズを含む int 値です。An int value containing the network packet size.

解説Remarks

このプロパティの値の許容範囲は、[-1 | 0 | 512..32767] です。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.

TLS (トランスポート層セキュリティ) (以前の SSL (Secure Sockets Layer)) 暗号化を使用して接続しているときに、アプリケーションで packetSize プロパティを設定する場合があります。The application might want to set the packetSize property while connecting with Transport Layer Security (TLS), previously known as Secure Sockets Layer (SSL), encryption. SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server では、パケット サイズがサーバーとの間でネゴシエートされます。The SQL Server 用 Microsoft JDBC ドライバーMicrosoft JDBC Driver for SQL Server negotiates the packet size with the server. encrypt プロパティが "true" に設定されている場合に、ネゴシエートされたパケット サイズが Java 仮想マシン (JVM) の既定のセキュリティ プロバイダーの TLS レコード サイズを超えるときは、ドライバーでエラーが発生して接続が終了します。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.

また、TLS 暗号化を要求せずにアプリケーションで packetSize プロパティが設定される場合もあります。In addition, the application might want to set the packetSize property without requesting the TLS encryption. この場合、クライアントによる TLS 暗号化のサポートをサーバーが求めている場合は、JVM の既定のセキュリティ プロバイダーの TLS レコード サイズが、ドライバーによってチェックされます。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. packetSize プロパティが JVM の既定のセキュリティ プロバイダーの TLS レコード サイズを超えるときは、ドライバーでエラーが発生して接続が終了します。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.

TLS の使用方法の詳細については、暗号化の使用に関するページを参照してください。For more information about using TLS, see Using encryption.

参照See Also

SQLServerDataSource のメンバー SQLServerDataSource Members
SQLServerDataSource クラスSQLServerDataSource Class