定義項目
カテゴリ | プロパティ | プロパティ名 | get | set | list | 再起動 |
|---|---|---|---|---|---|---|
× | × | ○ | － | |||
name | ○ | × | × | － | ||
resource-adapter-name | ○ | ○ | × | 必要 | ||
connection-definition-name | ○ | ○ | × | 必要 | ||
description | ○ | ○ | × | 必要 | ||
property.${PropertyName} | ○ | ○ | × | 必要 | ||
プール内の接続数 | ||||||
steady-pool-size | ○ | ○ | × | 不要 | ||
max-pool-size | ○ | ○ | × | 不要 | ||
pool-resize-quantity | ○ | ○ | × | 不要 | ||
idle-timeout-in-seconds | ○ | ○ | × | 必要 (注1) | ||
max-wait-time-in-millis | ○ | ○ | × | 不要 | ||
接続検証 | ||||||
is-connection-validation-required | ○ | ○ | × | 不要 (注2) | ||
fail-all-connections | ○ | ○ | × | 不要 | ||
トランザクション管理 | ||||||
transaction-support | ○ | ○ | × | 必要 | ||
× | × | ○ | － | |||
name | ○ | × | × | － | ||
principal | ○ | ○ | × | 必要 | ||
user-group | ○ | ○ | × | 必要 | ||
× | × | ○ | － | |||
user-name | ○ | ○ | × | 必要 | ||
password | ○ | ○ | × | 必要 | ||
アプリケーションからの初回アクセス時の設定値が有効になります。
アプリケーションクライアントコンテナおよびJava SEスタンドアロンアプリケーションでコネクタ接続プールを使用する場合、クライアント実行時の接続先であるInterstage Java EE 6 DASサービスまたはIJServerクラスタの接続検証の設定変更後に再起動が必要です。これは、クライアントのプロセスで作成されるコネクタ接続プールがInterstage Java EE 6 DASサービスまたはIJServerクラスタの定義項目の値を使用するためです。
■コネクタ接続プール
resources.connector-connection-pool.${jndi-name}
接続プール名
resources.connector-connection-pool.${jndi-name}.name
コネクタ接続プールの名前です。
なし
リソースアダプタ名
resources.connector-connection-pool.${jndi-name}.resource-adapter-name
関連付けされたリソースアダプタの名前です。
任意の文字列
なし
接続定義名
resources.connector-connection-pool.${jndi-name}.connection-definition-name
接続ファクトリのインタフェース名です。
任意の文字列
なし
説明
resources.connector-connection-pool.${jndi-name}.description
コネクタ接続プールの説明文です。
任意の文字列
なし
追加プロパティ
resources.connector-connection-pool.${jndi-name}.property.${PropertyName}
プロパティ名
半角英数字、マルチバイト文字、または特殊文字(‘-’、‘_’、‘.’、‘/’、‘;’、‘#’)
先頭には、半角英数字またはマルチバイト文字が指定可能
プロパティ値
任意の文字列
なし
初期および最小プールサイズ
resources.connector-connection-pool.${jndi-name}.steady-pool-size
プール内の接続の最小数を指定します。この値は、プールを最初に作成する時のプールに含まれる接続数としても使用されます。
最大プールサイズ以下の値を設定してください。
0～2147483647
8
最大プールサイズ
resources.connector-connection-pool.${jndi-name}.max-pool-size
プールに含まれる接続の最大数を指定します。プール数が最大プールサイズに達し、すべての接続が使用中の場合、接続要求はキューに格納されます。使用中の接続が解放されると、キューにたまった要求が取り出されて処理が実行されます。
初期および最小プールサイズ以上、かつプールサイズ変更量以上の値を設定してください。
1～2147483647
32
プールサイズ変更量
resources.connector-connection-pool.${jndi-name}.pool-resize-quantity
プールのサイズを最大プールサイズおよび最小プールサイズに対して拡大および縮小すると、一括処理でプールサイズが変更されます。ただし、プールサイズ変更時には最大プールサイズまで拡大し、最小プールサイズまで縮小するように変更します。この値は一括処理での接続の数を指定します。
最大プールサイズ以下の値を設定してください。
ポイント
本値を過大に設定すると、接続の作成と再利用が遅れ、過小に設定すると、効率が落ちます。
1～2147483647
2
アイドルタイムアウト
resources.connector-connection-pool.${jndi-name}.idle-timeout-in-seconds
プールで接続がアイドル状態のままでいられる最長時間(秒)を指定します。この時間を過ぎると、接続はプールから削除されます。
1～2147483647
300
最大待ち時間
resources.connector-connection-pool.${pool-name}.max-wait-time-in-millis
接続を要求するアプリケーションが接続タイムアウトになるまでに待つ時間(ミリ秒)を指定します。「0」が指定された場合、接続タイムアウトは発生しません。
0～2147483647
60000
接続検証
resources.connector-connection-pool.${jndi-name}.is-connection-validation-required
接続検証を有効にする(true)/しない(false)を指定します。
true
false
false
すべての障害で
resources.connector-connection-pool.${jndi-name}.fail-all-connections
有効にする(true)/しない(false)を指定します。
true
1つの接続障害を検出すると、アプリケーションサーバはプールに含まれるすべての接続を閉じ、初期および最小プールサイズで指定した数だけ接続を再確立します。この際、クローズされた接続は接続検証に失敗した接続としてみなされます。
false
クライアントからの接続要求の契機でプールから取り出した接続に対して接続検証を行い、検証に失敗した接続のみを破棄します。
true
false
false
トランザクションサポート
resources.connector-connection-pool.${jndi-name}.transaction-support
ra.xmlに記載されたトランザクションサポートレベルを、指定したレベルより低いレベルへ上書きします。
XATransaction：XAトランザクションサポート
LocalTransaction：ローカルトランザクションサポート
NoTransaction：トランザクション非サポート
注意
運用中に定義を変更すると、プールに含まれるすべての接続が削除されます。
XATransaction
LocalTransaction
NoTransaction
なし
■セキュリティーマップ
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}
セキュリティーマップ名
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}.name
特定のセキュリティーマップの参照に使用する名前です。
なし
Principal(主体)
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}.principal
適切なバックエンド主体にマッピングされるアプリケーションの呼び出し側ユーザー名です。
任意の文字列
なし
ユーザーグループ
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}.user-group
適切なバックエンド主体にマッピングされるアプリケーションの呼び出し側グループ名です。
任意の文字列
なし
■Backend principal(バックエンド主体)
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}.backend-principal
ユーザー名
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}.backend-principal.user-name
バックエンド主体のユーザー名です。EISのユーザー名に該当します。
任意の文字列
なし
パスワード
resources.connector-connection-pool.${jndi-name}.security-map.${MapName}.backend-principal.password
バックエンド主体のパスワードです。EISユーザーのパスワードに該当します。
任意の文字列
なし
関連情報
詳細な説明や関連記事については、以下を参照してください。
