4.2 UCPでのプール・サイズの制御について
UCP JDBC接続プールには、プール・サイズの制御に使用される一連のプロパティがあります。これらのプロパティを使用すると、要求の増減につれて、プール内の接続数を増減できるようになります。この動的な動作は、不要な接続の維持に浪費される場合のあるシステム・リソースの節約に役立ちます。
この節では、以下のトピックについて説明します。
4.2.1 初期プール・サイズの設定
初期プール・サイズのプロパティは、接続プールの初回作成時または再初期化時に作成される使用可能な接続の数を指定します。通常、このプロパティは、プールを最適なサイズにすることで、発生する起動時間を削減するために使用されます。
値0は、接続を事前作成しないことを示します。デフォルト値は0です。次の例では、初期プール・サイズの構成を示します。
pds.setInitialPoolSize(5);
初期プール・サイズのプロパティが最大プール・サイズのプロパティより大きい場合は、最大数の接続のみが初期化されます。
初期プール・サイズのプロパティが最小プール・サイズのプロパティより小さい場合は、初期数の接続のみが初期化され、最小プール・サイズ値を満たす十分な接続が作成されるまで維持されます。
4.2.2 最小プール・サイズの設定
最小プール・サイズのプロパティは、プールが保持する使用可能な接続および流用された接続の最小数を指定します。接続プールがまだ最小サイズに達していない場合を除いて、常に指定された最小プール・サイズに戻ろうとします。たとえば、最小限度が10に設定され、まだ2つの接続しか作成および流用されていない場合は、この数値が最小プール・サイズを下回っているため、プールで保持される接続数は2のままです。
このプロパティを使用すると、要求が減少するにつれてプール内の接続数を減らすことができます。同時に、システム・リソースが不要な接続の維持のために浪費されないようにします。
デフォルト値は0です。次の例では、最小プール・サイズの構成を示します。
pds.setMinPoolSize(2);
4.2.3 最大プール・サイズの設定
最大プール・サイズのプロパティは、プールが保持する使用可能な接続および流用された(使用中の)接続の最大数を指定します。最大数の接続が流用された場合、プールに返されるまで接続は利用できません。
このプロパティを使用すると、要求が増加するにつれてプール内の接続数を増やすことができます。同時に、プールがシステムのリソースを使い果し、最終的にアプリケーションのパフォーマンスや可用性に影響を及ぼすほど大きくならないようにします。
値0は、プールで保持される接続がないことを示します。接続を取得しようとすると例外が発生します。デフォルト値では、最大でInteger.MAX_VALUE(デフォルトでは2147483647)まで接続を作成し続けることができます。次の例では、最大プール・サイズの構成を示します。
pds.setMaxPoolSize(100);