JDBC 接続プールの一般設定を編集する

JDBC 接続プールの編集時には、接続プール名以外のすべての設定を修正できます。

  1. ナビゲーションツリーで、「リソース」ノードを展開します。
  2. 「接続プール」ノードを選択します。

    「接続プール」ページが開きます。

  3. 編集する接続プールの名前をクリックします。

    「接続プールを編集」ページが開きます。


    注 – 「名前」フィールドは読み取り専用です。接続プール名は、新しい JDBC 接続プールの作成時にのみ指定できます。


  4. 「データソースクラス名」フィールドに、DataSource API または XADataSource API、あるいはその両方を実装するベンダー固有のクラスの名前を入力します。

    このクラスは JDBC ドライバにあります。

  5. 「リソースタイプ」ドロップダウンリストから、リソースタイプを選択します。

    選択肢には javax.sql.DataSource (ローカルトランザクションに限る)、javax.sql.XADataSource (グローバルトランザクション)、および java.sql.ConnectinPoolDataSource (ローカルトランザクション、パフォーマンス向上の可能性あり) があります。

  6. 「説明」フィールドに、接続プールの簡単な説明を入力します。
  7. 「初期および最小プールサイズ」フィールドに、このプールの最小接続数を入力します。

    この値は、プールを最初に作成したり、Enterprise Server を起動したりするときの、プールに含まれる接続の数も判定します。

  8. 「最大プールサイズ」フィールドに、このプールの最大接続数を入力します。
  9. 「プールサイズ変更量」フィールドに、プールサイズの変更バッチごとの接続数を入力します。

    プールのサイズを最大プールサイズおよび最小プールサイズに対して拡大および縮小すると、一括処理でプールサイズが変更されます。この値は一括処理での接続の数を指定します。この値を過大に設定すると接続の作成と再利用が遅れ、過小に設定すると効率が落ちます。

  10. 「アイドルタイムアウト」フィールドに、接続がプール内にアイドル状態で残ることができる最大時間を秒単位で入力します。

    この時間を過ぎると、接続はプールから削除されます。

  11. 「最大待ち時間」フィールドに、接続を要求しているアプリケーションが接続タイムアウトを受け取るまでに待機する最長時間をミリ秒単位で入力します。
  12. 「接続検証」の「必要」チェックボックスを選択して、接続検証を有効にします。

    接続検証によって、サーバーは障害発生時に再接続できます。

  13. 「検証方法」ドロップダウンリストから、検証方法を選択します。

    アプリケーションサーバーは、次の 3 つの方法でデータベース接続を検証できます。auto-commit、metadata、および table。

    auto-commit および metadata

    アプリケーションサーバーは、con.getAutoCommit() メソッドと con.getMetaData メソッドを呼び出して接続を検証します。


    注 – 多数の JDBC ドライバが、これらの呼び出しの結果をキャッシュします。その結果、これらの呼び出しを使用すると、信頼できる検証が行われない場合もあります。呼び出しがキャッシュされるかどうかについて、ドライバベンダーに問い合わせる必要があります。


    table

    アプリケーションは指定したデータベース表に問い合わせます。表は実在し、アクセス可能である必要がありますが、行は必要ありません。多くの行を持つ既存の表や、すでに頻繁にアクセスされている表を使用しないでください。

  14. 「検証方法」ドロップダウンリストで「table」を選択した場合、「テーブル名」フィールドにデータベーステーブルの名前を入力します。

    テーブル名に含めることができるのは、英数字、下線、ダッシュ、またはドットの各文字だけです。

  15. 単一接続障害が発生したときに、サーバーを閉じ、プールのすべての接続を再度確立するには、「すべての障害で全ての接続を閉じる」チェックボックスを選択します。

    このオプションが無効な場合、個々の接続はそれぞれの使用時のみ再度確立されます。

  16. 「コンポーネント以外の呼び出し元を許可」の「有効」チェックボックスを選択して、サーブレットフィルタやライフサイクルモジュールなどのコンポーネント以外の呼び出し元がプールを使用できるようにします。
  17. 「非トランザクション接続」の「有効」チェックボックスを選択して、非トランザクション接続を返すようにします。
  18. ドロップダウンリストから接続プールのトランザクション遮断レベルを選択します。

    指定しない場合、接続には JDBC ドライバによって設定されるデフォルトの遮断レベルが適用されます。

  19. プールから取得されるすべての接続が同じ遮断レベルになるように、「遮断レベル - 保証」チェックボックスを選択してください。

    たとえば、最後の使用時に con.setTransactionIsolation を使って接続の遮断レベルをプログラム的に変更した場合、このメカニズムによって状態が指定の遮断レベルに戻されます。

    この設定が適用されるのは、手順 18 でトランザクション遮断レベルが指定された場合のみです。

  20. 「保存」をクリックします。
参照