2.7.4 リソースアダプタの使用方法
リソースアダプタを使用してリソースと接続する場合，リソースアダプタをJ2EEリソースアダプタとしてデプロイしてください。J2EEリソースアダプタとは，J2EEサーバ上に配置されたリソースアダプタです。デプロイ方法については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.3.7 リソースアダプタの設定方法」を参照してください。
(1) リソースアダプタの機能
バッチサーバの場合にデータベース接続で使用できる機能を次の表に示します。それぞれの機能の詳細については，参照先の説明を参照してください。
|
機能 |
項目 |
説明 |
参照先マニュアル※1 |
参照個所 |
|---|---|---|---|---|
|
パフォーマンスチューニングのための機能 |
コネクションプーリング |
コネクションをメモリ上にプールしておくことで，アプリケーションからの接続要求に対して高速に処理できます。 |
基本・開発編(コンテナ共通機能) |
|
|
コネクションプールのウォーミングアップ |
サーバ起動時またはリソースアダプタ起動時に，指定した数のコネクションを作成します。コネクションをプールしておくことで，コネクションプール開始直後の接続要求を高速に処理します。 |
|||
|
コネクション数調節機能 |
一定間隔で，プール内の不要なコネクションを段階的に減少させます。 |
|||
|
コネクションシェアリング・アソシエーション |
コネクションを共有することで，コネクション取得処理に掛かる処理時間を短縮できます。 コネクションシェアリングでは，論理コネクションと接続先リソースのコネクションである物理コネクションを多対1で接続します。 バッチアプリケーションの場合，コネクションアソシエーションは使用できません。 |
|||
|
ステートメントプーリング |
PreparedStatementおよびCallableStatementを使用する処理の場合に，これらのステートメントをプーリングしておくことで，同じステートメント作成に掛かる処理時間を短縮できます。 |
|||
|
DataSourceオブジェクトのキャッシング |
JNDIインタフェースを使用して，DataSource型のオブジェクトの検索要求をする場合，DataSourceオブジェクトをキャッシングできます。 |
|||
|
DB Connectorのコンテナ管理でのサインオンの最適化 |
コンテナ管理でサインオンをする場合，サインオンの動作を最適化できます。 |
|||
|
フォールトトレランスのための機能 |
コネクション障害検知 |
プーリングされているコネクションにトラブルが発生していないかを検知できます。これによって，ユーザプログラムからのコネクション要求に対して，有効なコネクションだけを返却できます。 |
||
|
コネクション枯渇時のコネクション取得待ち |
コネクションプールに指定した最大数までコネクションがプールされていて，利用できるコネクションがない場合は，コネクション取得要求を待ち状態にできます。 |
|||
|
コネクション取得リトライ |
使用できるコネクションがコネクションプールにない場合や接続先リソースの物理コネクションの確立に失敗した場合に，自動的にコネクションの取得処理を再実行できます。 |
|||
|
コネクションプールの情報表示 |
コマンドを使用して，コネクションプール内のコネクションの情報を表示できます。 |
|||
|
コネクションプールのクリア |
データベースサーバにトラブルが発生してコネクションが切断された場合などに，不要なコネクションプールをコマンドで削除できます。 |
|||
|
ステートメントキャンセル |
実行中のSQL処理が返ってこない状態でトランザクションタイムアウトが発生した場合に，ステートメントをキャンセルできます。 |
|||
|
障害調査用SQLの出力 |
デッドロックやスローダウンなどの障害が発生した場合に，発行したSQLをログに出力できます。ログは，障害要因の解析に利用できます。 |
|||
|
オブジェクトの自動クローズ |
ユーザプログラムでオープンしたStatementオブジェクトなどをクローズできなかった場合に，DB Connectorによってオブジェクトを自動的にクローズできます。 |
|||
|
リソースへの接続テスト |
リソースへの接続テスト |
環境構築時に，リソースアダプタが正しく設定できているかどうかを確認できます。 |
||
|
Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能） |
J2EEリソースへの別名付与※2 |
J2EEリソースに別名を付与できます。バッチアプリケーションからは，別名として設定した任意の名称でルックアップできます。 |
||
|
性能解析トレースを使用したシステムの性能解析 |
コネクションIDのPRFトレース |
各機能が出力する性能解析情報を収集します。この情報を基に，システム性能およびボトルネックを分析できます。 |
保守／移行編 |
注※1 参照先のマニュアル名称は，「アプリケーションサーバ 機能解説」を省略しています。
注※2 バッチサーバの場合，リソースアダプタの別名は必ず使用します。
リソースアダプタの種類ごとに使用できる機能を次の表に示します。
|
機能 |
項目 |
リソースアダプタの種類 |
|---|---|---|
|
DB Connector |
||
|
パフォーマンスチューニングのための機能 |
コネクションプーリング |
○ |
|
コネクションプールのウォーミングアップ |
○ |
|
|
コネクション数調節機能 |
○ |
|
|
コネクションシェアリング・アソシエーション※ |
○ |
|
|
ステートメントプーリング |
○ |
|
|
DataSourceオブジェクトのキャッシング |
○ |
|
|
DB Connectorのコンテナ管理でのサインオンの最適化 |
○ |
|
|
フォールトトレランスのための機能 |
コネクション障害検知 |
○ |
|
コネクション枯渇時のコネクション取得待ち |
○ |
|
|
コネクション取得リトライ |
○ |
|
|
コネクションプールの情報表示 |
○ |
|
|
コネクションプールのクリア |
○ |
|
|
ステートメントキャンセル |
○ |
|
|
障害調査用SQLの出力 |
◎ |
|
|
オブジェクトの自動クローズ |
○ |
|
|
リソースへの接続テスト |
リソースへの接続テスト |
○ |
|
Enterprise BeanまたはJ2EEリソースへの別名付与（ユーザ指定名前空間機能） |
J2EEリソースへの別名付与※ |
○ |
|
性能解析トレースを使用したシステムの性能解析 |
コネクションIDのPRFトレース |
○ |
- （凡例）
-
◎：必ず有効になる
○：使用できる
注※ バッチアプリケーションの場合，コネクションアソシエーションは使用できません。
(2) リソースアダプタ以外の機能
ここでは，リソースアダプタ以外で実現される機能について説明します。ここで説明する機能は，リソースアダプタの種類に関係なく使用できます。
リソースアダプタ以外で実現される機能を，次の表に示します。それぞれの機能の詳細については，参照先の説明を参照してください。
|
機能 |
項目 |
説明 |
参照先マニュアル※ |
参照個所 |
|---|---|---|---|---|
|
パフォーマンスチューニングのための機能 |
ライトトランザクション |
ローカルトランザクションに最適化された環境を提供します。ライトトランザクション機能は必ず有効にします。 |
基本・開発編(コンテナ共通機能) |
|
|
フォールトトレランスのための機能 |
トランザクションタイムアウト |
トランザクション開始時間から一定時間経過した時点で呼び出し先のトランザクションをロールバックします。 |
基本・開発編(コンテナ共通機能) |
注※ 参照先のマニュアル名称は，「アプリケーションサーバ 機能解説」を省略しています。
- 注意事項
-
J2EEサーバのトランザクション管理の機能では，トランザクションを自動決着する機能がありますが，バッチサーバの場合，トランザクションの自動決着機能は使用できません。
(3) リソースアダプタのオプショナル名についての注意事項
同じオプショナル名で複数のリソースアダプタをデプロイしている場合，エラーメッセージが出力されて，リソースアダプタの開始に失敗します。