「接続プールを編集」ページを使用して、JDBC接続プールの一般プロパティを編集します。
「接続プールを編集」ページには、次のオプションが含まれます。
デフォルト値を持つ設定をデフォルト値に戻すボタン。デフォルト値を持たない設定は変更されません。
接続プール内の接続を再初期化するボタン。このボタンをクリックすると、既存の接続が破棄されます。プールで確立された接続が再作成され、プールが初期および最小プール・サイズに復元されます。
接続プールが使用可能であることを確認するボタン。このボタンをクリックしたときにエラー・メッセージが表示された場合は、データベース・サーバーが起動されているかどうかを確認してください。
接続プールの名前。このフィールドは読取り専用です。プール名を指定できるのは、新しいJDBC接続プールの作成時のみです。
選択できるのは、javax.sql.XADataSource(グローバル・トランザクション)、java.sql.ConnectionPoolDataSource(ローカル・トランザクション、パフォーマンス改善が可能)、javax.sql.DataSource(ローカル・トランザクションのみ)、およびjava.sql.Driver
です。
データソースを実装するベンダー固有のクラス名。
ベンダーが提供するJDBCドライバ・クラス名。java.sql.Driverリソース・タイプを選択した場合、通常このフィールドには、選択したドライバとデータベース・ベンダーに関連付けられたクラス名が自動的に入力されます。データソース・リソース・タイプのいずれかを選択した場合、このフィールドは無効になります。
このオプションを選択した場合、プールの作成または再構成中にプールに対して自動的にpingが実行され、誤った属性値が識別および警告されます。このオプションは、デフォルトでは無効になっています。
接続プールの簡単な説明。
プール内の接続の最小数。この値は、プールを最初に作成したり、GlassFish Serverを起動したときの、プールに含まれる接続の数も判定します。デフォルト値は8です。
プールに含まれる接続の最大数。デフォルト値は32です。
プールのサイズを最大プール・サイズおよび最小プール・サイズに対してスケール・アップおよびスケール・ダウンすると、一括処理でプール・サイズが変更されます。この値は一括処理での接続の数を指定します。この値を過大に設定すると接続の作成と再利用が遅れ、過小に設定すると効率が落ちます。デフォルト値は2です。
プール内でアイドル接続が許可される最大継続時間(秒)。この時間を過ぎると、接続はプールから削除されます。デフォルト値は300です。
接続をリクエストしているアプリケーションが接続タイムアウトを受け取るまでに待機するミリ秒単位の最長時間を指定します。デフォルト値は60,000です。
このオプションが有効な場合、非トランザクション接続が返されます。デフォルトでは、このオプションは指定されていません。
トランザクション分離レベルを指定する場合、このプール内の接続には指定されたレベルが適用されます。指定しない場合、接続にはJDBCドライバによって設定されるデフォルトの分離レベルが適用されます。デフォルトでは、このオプションは指定されていません。
「保証付き」チェックボックスを選択すると、プールから取得されるすべての接続が同じ分離レベルになります。たとえば、最後の使用時にcon.setTransactionIsolation
を使用して接続の分離レベルをプログラム的に変更した場合、このメカニズムによってステータスが指定の分離レベルに戻されます。
このフィールドが適用されるのは、トランザクション分離レベルが指定された場合のみです。