setPacketSize メソッド (SQLServerDataSource)

JDBC ドライバーのダウンロード

SQL Server との通信に使用される現在のネットワーク パケット サイズが設定されます (バイトで指定します)。

構文

  
public void setPacketSize(int packetSize)  

パラメーター

packetSize

ネットワーク パケット サイズを含む int 値です。

解説

このプロパティの値の許容範囲は、[-1 | 0 | 512..32767] です。 このプロパティが許容範囲外の値に設定されている場合は、例外が発生します。

TLS (トランスポート層セキュリティ) (以前の SSL (Secure Sockets Layer)) 暗号化を使用して接続しているときに、アプリケーションで packetSize プロパティを設定する場合があります。 SQL Server 用 Microsoft JDBC ドライバー では、パケット サイズがサーバーとの間でネゴシエートされます。 encrypt プロパティが "true" に設定されている場合に、ネゴシエートされたパケット サイズが Java 仮想マシン (JVM) の既定のセキュリティ プロバイダーの TLS レコード サイズを超えるときは、ドライバーでエラーが発生して接続が終了します。

また、TLS 暗号化を要求せずにアプリケーションで packetSize プロパティが設定される場合もあります。 この場合、クライアントによる TLS 暗号化のサポートをサーバーが求めている場合は、JVM の既定のセキュリティ プロバイダーの TLS レコード サイズが、ドライバーによってチェックされます。 packetSize プロパティが JVM の既定のセキュリティ プロバイダーの TLS レコード サイズを超えるときは、ドライバーでエラーが発生して接続が終了します。

TLS の使用方法の詳細については、暗号化の使用に関するページを参照してください。

参照

SQLServerDataSource のメンバー
SQLServerDataSource クラス