Administration Console オンライン ヘルプ
|
 |
 |
|
[JDBC 接続プール｜コンフィグレーション｜接続] タブでは、接続プールの接続数と各接続の詳細を指定します。
接続プールには、その接続プールの登録時 (通常は WebLogic Server の起動時) に作成される JDBC 接続のグループが含まれています。アプリケーションは、接続プールから接続を取得して使用し、その接続を閉じることによって接続プールに返却します。
1 つまたは複数のサーバまたはクラスタへの JDBC 接続プールのデプロイメント
『WebLogic JTA プログラマーズ ガイド』の「 サードパーティドライバのコンフィグレーションとパフォーマンス要件」
|
各物理データベース接続を作成するまでにかかる遅延時間 (秒単位)。この遅延は、最初にプールが作成されるときにも、プールの生存期間中に物理データベース接続が作成されるときにも発生する。 MBean: |
||
|
WebLogic Server がプールされた接続をまだ有効であると信頼し、接続テストをスキップする秒数。 接続がテストされるか正常に使用されて接続プールに返されたときから、アプリケーションが接続を要求するまでの時間がここで指定された時間内であれば、WebLogic Server は接続テストをスキップしてアプリケーションに接続を渡す (TestConnectionsOnReserve が有効化されている場合)。 接続が、ここで指定された時間内に正常に使用されて接続プールに返された場合には、WebLogic Server は自動リフレッシュ接続テストもスキップする (TestFrequencySeconds が指定されている場合)。 この属性は、(特にデータ転送量の多い状況下で) データベース接続テストによる遅延を最小限に抑えることにより、アプリケーションのパフォーマンスを向上できるチューニング機能。 ただしこの属性を使用すると、(過度に大きな値が設定されている場合には特に) 接続テストの効果が低減することがある。 適切な値は、環境によって、また接続が利用不可能になる可能性の高さによって異なる。 |
||
|
アプリケーションが基盤となるベンダ接続オブジェクトを使用した後で、接続プールから接続を削除して再作成するかどうかを制御する。
この属性を有効にすると、接続のプーリングが基本的に無効になる (接続がプールから削除され、新しい接続で置き換えられる) ため、パフォーマンスに影響を与える。 MBean: |
||
|
トラフィックの増加時に作成された接続が未使用であることが検出されたときにプールが 縮小する場合、接続数は初期容量または現在使用中の接続数のうち大きい方の値に減少される。 MBean: |
||
|
要求に合わせてインクリメンタルに容量が増大した接続プールを縮小するまでの待機秒数。接続プールを縮小するには、 MBean: |
||
|
JDBC 接続リークのプロファイリング情報を収集するかどうかを指定する。 接続リークは、プールからの接続が 接続リーク プロファイルがアクティブな場合、接続プールは、接続オブジェクトが接続プールから割り当てられ、クライアントに提供されたときにスタック トレースを格納する。接続リークが検出されたとき (接続オブジェクトのガベージ コレクションが行われたとき) に、このスタック トレースが報告される。 このオプションは、接続プールからのリークされた接続を表示する場合に必須である (リークされた接続を表示するには、接続プール名を右クリックして [リークされた接続を表示] を選択する)。 この機能はリソースを余計に使用し、接続プール処理を遅くする可能性があるので、プロダクション環境では使用しないほうがよい。 MBean: |
||
|
選択すると、WebLogic Server は接続オブジェクトが解放されて接続プールに戻されるときに必ずスタック トレースを格納する。 グローバル (XA) トランザクションに関連する接続で以降の処理時に例外が送出された場合は、その例外と共にスタック トレースが報告される。 この機能を使用して、アプリケーション コードで未完了のままになっているローカル トランザクションの処理を検出できる。こうした未完了の処理は、JDBC 接続での以降のグローバル (XA) トランザクション処理に干渉する場合がある。 この機能は通常の接続プール処理よりもリソースを多く使用し、接続プールのパフォーマンスを低下させる可能性があるので、プロダクション環境では使用しないほうがよい。 この機能は、非 XA JDBC ドライバで作成された接続には適用されない。 MBean: |
||
|
データベース接続テストの周期の秒数。
MBean: |
||
|
選択した場合 (true に設定した場合)、WebLogic Server は接続をテストしてからクライアントに提供する。このテストを行うと、クライアントがプールに接続を要求した場合、その要求に応えるまでに短い遅延が生じるが、クライアントでは有効な接続を確実に受け取ることができる (DBMS が利用可能およびアクセス可能であると仮定)。 TestConnectionsOnReserve を機能させるために、TestTableName 属性を有効にする必要がある。 TestTableName 属性は、高可用性アルゴリズムを使用するマルチプール内で使う接続プールで必要となる。 MBean: |
||
|
選択した場合 (true に設定した場合)、WebLogic Server は、接続の作成後、クライアントで使用できる接続リストに追加する前に、その接続をテストする。テストによって接続の作成時に短い遅延が発生するが、クライアントは有効な接続を確実に受け取ることができる (DBMS が利用可能およびアクセス可能であると仮定)。TestConnectionsOnCreate を機能させるために、TestTableName 属性を設定する必要がある。 MBean: |
||
|
選択した (true に設定した) 場合、WebLogic Server は接続をテストしてから接続プールに返す。プール内のすべての接続がすでに使用中で、かつクライアントが接続を待機している場合、接続のテスト中はクライアントの待機時間がやや長くなる。TestConnectionsOnRelease を有効にするには、TestTableName 属性を有効にする必要がある。 MBean: |
||
|
接続プールから接続を予約する呼び出しがタイムアウトになるまでの秒数。 MBean: |
||
|
接続プールの作成時にデータベース接続の作成を試行する間隔 (秒単位)。この値を設定しないと、データベースが使用できない場合に接続プールの作成が失敗する。この値を設定しておくと、接続プールの作成時にデータベースが使用できない場合でも、指定した秒数の経過後にプールで接続の作成が再試行される。正常に接続が作成されるまで、引き続き接続の作成が試行される。 MBean: |
||
|
予約された接続が強制的にプールに解放されるまで、接続が非アクティブになっている秒数。 MBean: |
||
|
プールからの接続の予約を待機しながら同時にブロックできる接続要求の最大数。 MBean: |
||
|
接続の更新などの目的で (アプリケーションで) 使用不可にできるプール内の接続の最大数。バックエンド システムが使用不能になっている場合、ここで指定した値はプールの制御以外の要因で超過する可能性がある。 MBean: |
||
|
物理データベース接続のテスト時に使用されるテーブルの名前。接続をテストする際に使用されるデフォルト SQL コードは、次の通り。
MBean: |
||
|
接続を初期化する際に使用される SQL コード。[初期化 SQL] の値を指定すると、WebLogic Server ではデータベース接続が作成されるときにクエリが実行される。[初期化 SQL] の値を指定しない場合、WebLogic Server では接続を初期化する SQL コードは実行されない。 コードは、まず「 MBean: |
||
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
このオプションを選択すると、接続プールで強制的に物理接続を予約し、トランザクションの処理全体において、そのトランザクションが完了するまで、アプリケーションに対して同じ接続を提供できる。 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
データベース接続の作成に使用される XA ドライバで、さまざまな JDBC オブジェクト (結果セット、文、接続など) を閉じるときに分散トランザクション コンテキストが必要になる場合に、このオプションを選択する。 選択すると、JDBC オブジェクトを閉じるときに送出される SQL 例外のうち、トランザクション コンテキストでないものが無条件で受信される。 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
DBMS へのデータベース接続の作成に使用される XA ドライバで、分散トランザクションのコミットおよびロールバック処理に対して専用の XA 接続が必要になる場合に、このオプションを選択する。 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
DBMS へのデータベース接続の作成に使用される XA ドライバで、保留中の各 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
このオプションを選択すると、接続用に XA リソース マネージャ (通常は JDBC ドライバ) を使用して、トランザクション ブランチのタイムアウトを設定できる。 選択した場合、WebLogic Server トランザクション マネージャにより、 トランザクション ブランチ タイムアウトの設定は、XA リソース上のデフォルトのタイムアウト値を超過するような、長時間実行されるトランザクションがある場合に利用できる。 注意: この機能を使用するには、リソース マネージャ (通常は JDBC ドライバ) で MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
トランザクション ブランチ タイムアウトとして設定する秒数。 設定した場合、XA リソース マネージャ (通常は JDBC ドライバ) 上の この値を 設定する際には、グローバル WebLogic Server トランザクション タイムアウトと同じかそれ以上の値にする必要がある。 注意: [XA トランザクション タイムアウト] 属性を有効にするには、[XA トランザクション タイムアウトを有効化] を選択しなくてはならない。 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
トランザクション マネージャがリソースに対して回復、ロールバック、およびコミット処理の実行を再試行する期間を秒数で指定する。 値 0 を指定すると、再試行は行われない。 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
XA 再試行処理を行う間隔を秒数で指定する ([ MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
DBMS へのデータベース接続の作成に使用される XA ドライバで、物理 XA 接続が XA 接続プールに返されても、トランザクション処理が継続している間は論理 JDBC 接続が開いたまま保持される必要がある場合に、このオプションを選択する。 MBean: |
|
|
注意: このオプションは、接続プールでの物理データベース接続の作成に XA JDBC ドライバが使用される場合にのみ使用可能。 |
データベース接続の作成に使用される XA ドライバで、グローバル トランザクションを使用しない SQL がサポートされている場合に、このオプションを選択する。 MBean: |
|
|
|