Sun GlassFish Enterprise Server v2.1.1 管理ガイド

JDBC 接続プールの詳細属性の編集

接続リークを診断しやすくし、使い勝手を向上させるため、Application Server 9.1 には接続プールをその作成時点で設定するための新しい属性がいくつか用意されています。

  1. 「詳細」タブを開いて、次の属性を指定します。

    属性 

    説明 

    名前 

    プロパティーを編集する JDBC 接続プールの名前。ただし、プール名は変更できません。 

    文のタイムアウト 

    異常に長い時間実行されているクエリーを終了させるまでの時間 (秒数)。Application Server は、作成された文に対して「QueryTimeout」を設定します。デフォルト値の -1 は、この属性が無効であることを示します。 

    JDBC オブジェクトをラップ 

    true に設定すると、アプリケーションは Statement、PreparedStatement、CallableStatement、ResultSet、DatabaseMetaData に対してラップされた JDBC オブジェクトを取得します。デフォルト値は false です。 

  2. 次の表の説明に従って、接続設定を指定します。

    属性 

    説明 

    最大で 1 回検証 

    経過するまでに 1 回しか接続が検証されない時間 (秒)。これは、1 つの接続による検証要求の数を減らすのに役立ちます。デフォルト値の 0 は、接続の検証が無効であることを示します。 

    リークタイムアウト 

    接続プール内の接続リークを追跡する時間 (秒)。デフォルト値の 0 は、接続リーク追跡が無効であることを示します。接続リーク追跡を有効にすると、「リソースの監視」タブに接続リークの数に関する統計情報が表示されます。このタブを表示するには、「Application Server」->「監視」->「リソース」の順に選択します。  

    リーク再要求 

    このオプションを有効にすると、リーク接続の追跡が完了したあとで、リークした接続がプールにリストアされます。 

    作成再試行回数 

    新しい接続の作成に失敗した場合に行われる試行の回数。デフォルト値の 0 は、接続の再試行が行われないことを示します。 

    再試行間隔 

    接続作成の試行の間隔 (秒数) を指定します。デフォルト値は 10 秒です。この属性は、「作成再試行回数」が 1 以上の場合にのみ使用されます。 

    使用時にのみ接続を登録 

    リソースが実際にメソッドで使用される場合にのみリソースをトランザクションに登録するには、このオプションを有効にします。 

    使用時にのみ関連付け 

    接続に対して操作が実行された時点ではじめて接続が関連付けられます。また、トランザクションが完了してコンポーネントメソッドが終了したときに関連付けが解除されるため、物理的な接続を再利用しやすくなります。デフォルト値は false です。 

    スレッドとの関連付け 

    接続をスレッドに関連付けるには、このオプションを有効にします。これにより、同じスレッドが接続を必要とするときは、そのスレッドにすでに関連付けられている接続を再利用できるため、プールから接続を取得するオーバーヘッドが発生しません。デフォルト値は false です。 

    接続のマッチング  

    プールに対する接続マッチングのオン/オフを切り替えるには、このオプションを使用します。プール内の接続が常に同じ種類であり、プールから選択した接続とリソースアダプタを照合する必要がない場合は、false に設定できます。デフォルト値は false です。 

    最大接続使用数 

    接続をプールで再利用する回数を指定します。指定された回数だけ再利用されると、その接続は閉じられます。これは、たとえば、文リークを回避するのに役立ちます。デフォルト値の 0 は、接続が再利用されないことを示します。