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

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

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

  4. 「接続プール」ページで、編集するプールの名前をクリックします。

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

  5. 「接続プールを編集」ページで、「詳細」タブをクリックします。

    「接続プールの詳細属性を編集」ページが開きます。

  6. 「文のタイムアウト」フィールドに、実行時間が異常に長いクエリーを停止するまでの時間を秒単位で入力します。

    GlassFish サーバー は、作成される文に QueryTimeout を設定します。値を -1 に設定すると、このオプションが無効になります。デフォルト値は -1 です。

  7. 「文のキャッシュサイズ」フィールドに、LRU (Least Recently Used) キャッシュメカニズムを使用してキャッシュされる文の数を入力します。

    文のキャッシュを無効にするには、0 を指定します。デフォルト値は 0 です。

  8. 「SQL の初期化」フィールドに、接続がプールに作成される (再使用でない) ときに実行される SQL 文字列を入力します。

    この文字列の実行で、接続の状態が初期化されます。

  9. 「SQL トレースリスナー」フィールドに、リスナー実装クラス名のコンマ区切りのリストを入力して、アプリケーションによって実行される SQL 文を監視することを指定します。

    リスナークラスは org.glassfish.api.jdbc.SQLTraceListener インタフェースを実装する必要があります。リスナーを使用すると、SQL 文のログメッセージに簡単にフィルタを適用することができ、管理者が文を解析する際に役立ちます。

  10. アプリケーションの「JDBC オブジェクトをラップ」の「有効」チェックボックスを選択して、StatementPreparedStatementCallableStatementResultSetDatabaseMetaData に対してラップされた JDBC オブジェクトを取得します。

    このオプションはデフォルトで有効になっています。

  11. 「プール」チェックボックスを選択して、プールの接続プールを有効にします。

    このオプションはデフォルトで有効になっています。

  12. 「最大で 1 回検証」フィールドに、接続を最大で 1 回だけ検証するまでの時間を秒単位で入力します。

    この属性を適切な値に設定すると、接続ごとの確認要求回数を最小にすることができます。デフォルト値は 0 です。この属性が無効であることを意味します。

  13. 「リークタイムアウト」フィールドに、接続プールの接続リークを監視する時間を秒単位で入力します。

    このフィールドを使用して、アプリケーションによる接続リークの可能性を検出します。アプリケーションが指定された期間内に接続をプールに戻さなかった場合、この接続はリークしている可能性があると見なされ、呼び出し側のスタックトレースがログに記録されます。接続リークのトレースを無効にするには、値を 0 に設定します。デフォルト値は 0 です。

    このフィールドを「リーク再要求」とともに使用すると、アプリケーションによる潜在的な接続リークを避けることができます。

  14. リーク接続のトレースの完了後に、リークした接続をプールに戻すには、「リーク再要求」チェックボックスを選択します。

    このオプションは、デフォルトでは無効になっています。

  15. 「作成再試行回数」フィールドに、新しい接続の作成時に障害が発生した場合の試行回数を入力します。

    値を 0 に設定すると、接続の再作成は試行されません。デフォルト値は 0 です。

  16. 「再試行間隔」フィールドに、接続作成の試行間隔を秒単位で入力します。

    デフォルト値は 10 です。この属性は、「作成再試行回数」が 1 以上の場合にのみ使用されます。

  17. 「使用時にのみ関連付け」の「有効」チェックボックスを選択して、物理的な接続を、接続が使用されているときにのみ論理的な接続に関連付けます。

    トランザクションが完了してコンポーネントメソッドが終了したときに関連付けが解除されるため、物理的な接続を再利用しやすくなります。このオプションが無効な場合、物理的な接続は使用される前でも論理的な接続に関連付けられます。このオプションは、デフォルトでは無効になっています。

  18. 「使用時にのみ接続を登録」の「有効」チェックボックスを選択して、リソースが実際にメソッドで使用されるときのみ、トランザクションにリソースを登録します。

    このオプションは、デフォルトでは無効になっています。

  19. 「スレッドとの関連付け」の「有効」チェックボックスを選択して、接続とスレッドの間の関連付けを作成します。

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

  20. 「接続のマッチング」の「有効」チェックボックスを選択して、プールに対する接続の照合を有効にします。

    このオプションが有効な場合、プールから選択された接続は、特定の証明書を持つ接続にマッチングされます。複数のユーザー証明書を持つアプリケーションによって接続プールが使用されている場合は、このオプションを有効にする必要があります。プール内の接続が常に同じ種類であり、プールから選択した接続とリソースアダプタを照合する必要がないことを管理者が理解している場合は、このオプションを無効に設定できます。このオプションは、デフォルトでは無効になっています。

  21. 「最大接続使用数」フィールドに、接続をプールで再利用する回数を入力します。

    指定された回数だけ再利用されると、その接続は閉じられます。接続を再利用できる回数を制限することにより、アプリケーションが文を閉じていない場合に、文のリークを避けることができます。この属性を無効にするには、値を 0 に設定します。デフォルト値は 0 です。

  22. 「接続検証」の「必要」チェックボックスを選択して、接続検証を有効にします。

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

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

    GlassFish サーバー は、データベース接続を次の方法で検証できます。

    auto-commit および metadata

    GlassFish サーバー は、con.getAutoCommit メソッドと con.getMetaData メソッドを呼び出して接続を検証します。


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


    custom-validation

    GlassFish サーバー は、カスタム実装クラスで「検証クラス名」フィールドに指定した、ユーザー定義の検証メカニズムを使用します。

    table

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

  24. 「検証方法」ドロップダウンリストで「table」を選択した場合は、「テーブル名」ドロップダウンリストからデータベース表の名前を選択します。
  25. 「検証方法」ドロップダウンリストで「custom-validation」を選択した場合は、カスタム検証の実装クラス名を入力します。

    指定したクラス名は、GlassFish サーバー からアクセス可能である必要があります。指定したクラスは、 org.glassfish.api.jdbc.ConnectionValidation インタフェースを実装する必要があります。

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

    このオプションが無効な場合、個々の接続はそれぞれの使用時のみ再度確立されます。このオプションは、デフォルトでは無効になっています。

  27. 「コンポーネント以外の呼び出し元を許可」の「有効」チェックボックスを選択して、サーブレットフィルタや他社の持続マネージャーなどのコンポーネント以外の呼び出し元がプールを使用できるようにします。

    コンポーネント以外の呼び出し元によって取得された接続は、トランザクションの終わりにコンテナによって自動的に閉じられません。呼び出し元が明示的に閉じる必要があります。このオプションは、デフォルトでは無効になっています。

  28. (省略可能) 「一般」タブの「フラッシュ」ボタンをクリックして、プールからすべての接続をフラッシュします。

    「フラッシュ」ボタンをクリックすると、既存の接続が破棄されます。プールで確立された接続が再作成され、プールが初期および最小プールサイズに復元されます。

  29. 「保存」をクリックします。

    ヒント - デフォルト設定に戻すには、「デフォルトを読込み」ボタンをクリックし、「保存」を保存します。


参照
Copyright © 2010, Oracle and/or its affiliates. All rights reserved. 著作権について