11.8 DB Connector属性ファイルの設定
Java Batch 1.0ではジョブリポジトリの永続化先DBMSと接続するためにDB Connectorの設定が必要になります。
Java Batch 1.0で使用できるDB ConnectorはDBConnector_HiRDB_Type4_XA.rarだけです。
なお,Java Batch 1.0で使用するDB Connectorとジョブ内の業務で使用するDB Connectorは分けて別々にデプロイしてください。
Java Batch 1.0で使用するDB Connectorで使用できる機能を次の表に示します。使用できない機能を有効にした場合の動作は保証しません。
機能名 |
使用可否 |
---|---|
コネクションプーリング |
使用できる。必ず有効にしてください。 |
コネクションプールのウォーミングアップ |
使用できる。必ず有効にしてください。 |
コネクション数調節機能 |
使用できる。必ず有効にしてください。 |
コネクションシェアリング |
使用できる。 |
アソシエーション |
使用できない。 |
ステートメントプーリング |
使用できない。 |
DataSourceオブジェクトのキャッシング |
使用できる。 |
DB Connectorのコンテナ管理でのサインオンの最適化 |
使用できる。 |
コネクションの障害検知 |
使用できる。必ず有効にしてください。 |
コネクション障害検知のタイムアウト |
使用できる。必ず有効にしてください。 |
コネクション枯渇時のコネクション取得待ち |
使用できる。必ず有効にしてください。 |
コネクションの取得リトライ |
使用できる。 |
コネクションプールの情報表示 |
使用できる。 |
コネクションプールのクリア |
使用できる。 |
コネクションの自動クローズ |
使用できる。必ず有効にしてください。 |
コネクションスイーパ |
使用できる。 |
ステートメントキャンセル |
使用できない。 |
障害調査用SQLの出力 |
使用できる。 |
オブジェクトの自動クローズ |
使用できる。 |
リソースへの接続テスト |
使用できる。 |
J2EEリソースへの別名付与 |
使用できる。 |
コネクションIDのPRFトレース |
使用できる。 |
ステートメントsetQueryTimeoutメソッド |
使用できる。 |
クライアントAPIで発生した例外の通知機能 |
使用できる。 |
Java Batch 1.0で使用するDB Connector のConnector属性ファイルに設定する内容を次の表に示します。記載されていない項目は,設定不要です。
指定するタグ |
設定内容 |
---|---|
<config-property>タグのdescription |
データベースへの接続に必要な接続付加情報を設定します。 |
<config-property>タグのDBHostName |
接続するHiRDBのホスト名を設定します。 |
<config-property>タグのXAOpenString |
XAオープン文字列を設定します。 |
<config-property>タグのHiRDBCursorMode |
HiRDBがコミットした場合にResultSetクラスのオブジェクトを有効とするかどうかの設定です。falseを指定してください※1。 |
<config-property>タグのPreparedStatementPoolSize |
PreparedStatementプール数の設定です。0(ステートメントをプールしない)を指定してください。 |
<config-property>タグのCallableStatementPoolSize |
CallableStatementプール数の設定です。0(ステートメントをプールしない)を指定してください。 |
<config-property>タグのCancelStatement |
ステートメントをキャンセルするかどうかの設定です。false(実行中のSQLをキャンセルしません)を指定してください。 |
<property>タグのMaxPoolSize |
プール内のコネクションの最大数を指定します※2。 |
<property>タグのMinPoolSize |
プール内のコネクションの最小数を指定します。 |
<property>タグのUser |
ユーザ名を指定します。 |
<property>タグのPassword |
パスワードを指定します。 |
<resource-external-property>-<optional-name>タグ |
リソースの別名を設定します。ユーザプロパティ(ejbserver.javaee.batch.jobRepository.jndiName)と同じ値を設定してください。 |