ページの先頭行へ戻る
Interstage Application Server/Interstage Web Server Java EE運用ガイド

9.6.6 コネクタ接続プールの定義項目

定義項目

項目名

省略値

範囲

説明

再起動要否

(※1)

接続プール名

  

  • 半角英数字、または特殊文字('-'、'_'、'.'、'/'、';')。

  • 先頭には、半角英数字または‘_’のみ指定可。

  • 1~255文字の文字列

コネクタ接続プールの名前です。

リソースアダプタ名

  

文字列

関連付けされたリソースアダプタの名前です。

接続定義名

  

文字列

接続ファクトリのインタフェース名です。

説明

  

文字列

コネクタ接続プールの説明文です。

追加プロパティ

  

■プロパティ名:
半角英数字、マルチバイト文字、または特殊文字(‘-’、‘_’、‘.’、‘/’、‘;’、‘#’)。
先頭には、半角英数字もしくはマルチバイト文字を指定可。
■プロパティ値:
文字列

  

プール内の接続数

初期および最小プールサイズ

8

0~2147483647
(最大プールサイズ以下)

プール内の接続の最小数を指定します。この値は、プールを最初に作成する時のプールに含まれる接続数としても使用されます。

×

最大プールサイズ

32

1~2147483647
(初期および最小プールサイズ以上、かつプールサイズ変更量以上)

プールに含まれる接続の最大数を指定します。プール数が最大プールサイズに達し、すべての接続が使用中の場合、接続要求はキューに格納されます。使用中の接続が解放されると、キューにたまった要求が取り出されて処理が実行されます。

×

プールサイズ変更量

2

1~2147483647
(最大プールサイズ以下)

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

×

アイドルタイムアウト

300

1~2147483647

プールで接続がアイドル状態のままでいられる最長時間(秒)を指定します。この時間を過ぎると、接続はプールから削除されます。


(※2)

最大待ち時間

60000

0~2147483647

接続を要求するアプリケーションが接続タイムアウトになるまでに待つ時間(ミリ秒)を指定します。0が指定された場合、接続タイムアウトは発生しません。

×

接続検証

接続検証

  

  • true

  • false

接続検証を有効にします。

×

すべての障害で

false

  • true

  • false

この設定を有効にした場合、1つの接続障害を検出すると、アプリケーションサーバはプールに含まれるすべての接続を閉じ、初期および最小プールサイズで指定した数だけ接続を再確立します。この際、クローズされた接続は接続検証に失敗した接続としてみなされます。
無効の場合は、クライアントからの接続要求の契機でプールから取り出した接続に対して接続検証を行い、検証に失敗した接続のみを破棄します。

×

トランザクション管理

トランザクションサポート

  

  • XATransaction

  • LocalTransaction

  • NoTransaction

ra.xmlに記載されたトランザクションサポートレベルを、指定したより低いレベルへ上書きします。

×

コネクタのセキュリティ

セキュリティーマップ名

  • 半角英数字、または特殊文字('-'、'_'、'.'、'/'、';')。

  • 先頭には、半角英数字または‘_’のみ指定可。

  • 1~512文字の文字列

特定のセキュリティーマップの参照に使用する名前です。

Principal(主体)

  

文字列

適切なバックエンド主体にマッピングされるアプリケーションの呼び出し側ユーザー名です。

ユーザーグループ

  

文字列

適切なバックエンド主体にマッピングされるアプリケーションの呼び出し側グループ名です。

ユーザー名

  

文字列

バックエンド主体のユーザー名です。EISのユーザー名に該当します。

パスワード

  

文字列

バックエンド主体のパスワードです。EISユーザーのパスワードに該当します。

※1:IJServerクラスタの再起動が必要かどうかを示しています。
    ○:再起動必要、×:再起動不要

※2:アプリケーションからの初回アクセス時の設定値が有効になります。

関連情報

詳細な説明や関連記事については、以下を参照してください。

内容

参照先

機能説明

3.16 コネクタの提供機能

チューニング方法

7.11 コネクタのチューニング

コマンド

asadminコマンドの以下のサブコマンド
  11.1.4.1 getサブコマンド
  11.1.4.2 setサブコマンド
  11.1.4.3 listサブコマンド
  11.1.14.21 create-connector-connection-poolサブコマンド
  11.1.14.22 delete-connector-connection-poolサブコマンド
  11.1.14.23 list-connector-connection-poolsサブコマンド
  11.1.18.4 create-connector-security-mapサブコマンド
  11.1.18.5 delete-connector-security-mapサブコマンド
  11.1.18.6 update-connector-security-mapサブコマンド
  11.1.18.7 list-connector-security-mapsサブコマンド

asadminコマンドでの定義項目名

11.18.2.9 resources.connector-connection-poolの定義項目