HTTP セッション・データベース (httpSessionDatabase)
HTTP セッションがデータベースに対してどのように持続されるかを制御します。
| 属性名 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|
| dataSourceRef | string | セッション・マネージャーが HTTP セッション・データを持続させるために使用するデータ・ソースの ID。 | |
| db2RowSize |
|
4KB | DB2 データベースを使用する場合に、セッション・テーブル用に構成されているテーブル・スペースのページ・サイズを指定します。環境によっては、この値を増やすことでデータベースのパフォーマンスの向上が図れます。
|
| noAffinitySwitchBack | boolean | false | 新規メンバーに対するアフィニティーを元のメンバーの復旧後にも維持する場合は、このプロパティーを「true」に設定します。クラスター・メンバーに障害が起こった場合、その要求は別のクラスター・メンバーにルーティングされ、セッションはその別のメンバー内でアクティブ化されます。したがって、セッション・アフィニティーは新規メンバーに対して維持され、障害が起こったクラスター・メンバーが復旧すると、その元のクラスター・メンバーで作成されたセッションに対する要求は、再びその元のメンバーに経路指定されます。 許可された値は true または false で、デフォルトは false です。分散セッションを時間ベースの書き込みで構成している場合、このプロパティーを true に設定します。分散セッションが使用可能でない場合、このプロパティーは振る舞いに影響を与えないことに注意してください。 |
| onlyCheckInCacheDuringPreInvoke | boolean | false | 値 true は、要求がセッションを取得した場合にのみ、セッションの最終アクセス時間を更新するように指示します。値 false は、すべての要求時に、セッションの最終アクセス時間を更新するように指示します。環境によっては、この値を変更することでパフォーマンスの向上が図れます。 |
| optimizeCacheIdIncrements | boolean | true | ユーザーのブラウザー・セッションで複数の Web アプリケーション間を移動すると、Web モジュールのメモリー内セッションがパーシスタント・ストアから更新される際に、追加のパーシスタント・ストア・アクティビティーが発生する場合があります。その結果として、キャッシュ ID が連続的に増加して、メモリー内セッションの属性がパーシスタント・コピーの属性によって上書きされます。キャッシュ ID が増加し続けないようにする場合は、このプロパティーを true に設定します。値を true に設定すると、Web モジュールのメモリー内セッションがパーシスタント・ストアのコピーより古いかどうかをセッション・マネージャーが評価します。クラスター構成の場合は、各クラスター・メンバーのシステム時間が可能な限り同じになるようにしてください。 |
| scheduleInvalidation | boolean | false | このオプションを使用可能にすると、HTTP セッションの活動状態の維持に必要なデータベース更新の数が削減されます。1 日の中で、アプリケーション・サーバーにおいて最もアクティビティーが少ない 2 時間を指定します。このオプションが使用不可の場合、無効化された HTTP セッションを除去するために、無効化プロセスが数分ごとに実行されます。 |
| scheduleInvalidationFirstHour | int | 0 | 無効化されたセッションがパーシスタント・ストアから消去される最初の時間を示します。この値は、0 から 23 の整数で指定します。この値は、スケジュールの無効化が使用可能である場合のみ有効です。 |
| scheduleInvalidationSecondHour | int | 0 | 無効化されたセッションがパーシスタント・ストアから消去される 2 番目の時間を示します。この値は、0 から 23 の整数で指定します。この値は、スケジュールの無効化が使用可能である場合のみ有効です。 |
| skipIndexCreation | boolean | false | サーバー始動時に索引作成を使用不可にするには、このプロパティーを「true」に設定します。このカスタム・プロパティーは、セッション・パーシスタンスのため独自のデータベース索引を 手動で作成したい場合のみに使用してください。ただし、推奨するのは、セッション・マネージャーがデータベース索引を作成するようにすることです。このプロパティーを使用可能にする前に、正しい索引がセッション・データベースに存在することを確認してください。 |
| tableName | string | sessions | データベース・テーブル名。 |
| tableSpaceName | string | セッション・テーブルに使用するテーブル・スペース。この値が必要になるのは、DB2 行サイズが 4KB を超えている場合のみです。 | |
| useInvalidatedId | boolean | true | このプロパティーを「true」に設定すると、着信 ID のあるセッションが最近無効になった場合、その着信 ID が再使用されます。 この操作を行うと、パーシスタント・ストアがチェックされないため、パフォーマンスの最適化が図れます。 |
| useMultiRowSchema | boolean | false | 使用可能にした場合、各セッション・データ属性はデータベースで別々の行に置かれます。これにより、各セッション当たりの保管データ量を増やすことができます。セッション属性がかなり大きく、またセッション属性への変更が少なくて済む場合は、この構成によりパフォーマンスが向上する可能性があります。使用不可にした場合、すべてのセッション・データ属性が、セッションごとに同じ行に置かれます。 |
| useOracleBlob | boolean | false | このプロパティーを「true」に設定すると、中間列にバイナリー・ラージ・オブジェクト (BLOB) データ型を使用してデータベース・テーブルを作成します。この値により、Oracle データベースが使用されている場合に、パーシスタント・セッションのパフォーマンスが向上します。Oracle の制限により、4000 バイトを超えるデータの場合、BLOB サポートには Oracle Call Interface (OCI) データベース・ドライバーを使用する必要があります。また、サーバーを再始動する前に、古いセッション・テーブルを除去するか、セッション・テーブルが含まれないデータベースを参照するようにデータ・ソース定義を変更して、新規セッション・テーブルが確実に作成されるようにする必要もあります。 |
| usingCustomSchemaName | boolean | false | セッション・パーシスタンスのために DB2 を使用しており、データ・ソースに currentSchema プロパティーが設定されている場合、このプロパティーを「true」に設定してください。 |
| writeContents |
|
ONLY_UPDATED_ATTRIBUTES | どのくらいのセッション・データをパーシスタント・ストアに書き込むかを指定します。デフォルトでは、更新された属性のみを書き込みますが、代わりに (変更の有無に関係なく) すべての属性を書き込むことが可能です。
|
| writeFrequency |
|
END_OF_SERVLET_SERVICE | セッション・データがパーシスタント・ストアに書き込まれるタイミングを指定します。デフォルトでは、サーブレットの実行完了後に、セッション・データがパーシスタント・ストアに書き込まれます。環境によっては、この値を変更することでパフォーマンスの向上が図れます。
|
| writeInterval | 期間 (精度: 秒) | 2m | セッション・データをパーシスタント・ストアに書き込むまでに経過する必要がある秒数。デフォルトは 120 秒です。この値は、時間ベースの書き込み頻度が使用可能の場合にのみ使用されます。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 |
参照トピック