HiRDB Version 8の場合の前提条件について示します。

• 使用できるJDBCドライバ
  使用できるJDBCドライバはHiRDB Type4 JDBC Driverとなります。
  
• 接続方法
  次のどちらかのRARファイルを使用します。
  
  • DBConnector_HiRDB_Type4_CP.rar
  • DBConnector_HiRDB_Type4_XA.rar
  RARファイルの種類に応じて，指定できるトランザクションサポートレベルが異なります。また，ライトトランザクションを使用できるかどうかも異なります。
  RARファイルごとに指定できるトランザクションサポートレベルを次の表に示します。
  

  表3-25　RARファイルごとに使用できるトランザクションサポートレベル（HiRDB Version 8）

  使用するDB Connector （RARファイル）	トランザクションサポートレベル	ライトトランザクション
  		有効	無効
  DBConnector_HiRDB_Type4_CP.rar	NoTransaction LocalTransaction	○	○
  DBConnector_HiRDB_Type4_XA.rar	XATransaction	−	○

  （凡例）　○：使用できる　　−：該当しない

  
  

HiRDB Version 9の場合の前提条件について示します。

• 使用できるJDBCドライバ
  使用できるJDBCドライバはHiRDB Type4 JDBC Driverとなります。
  
• 接続方法
  次のどれかのRARファイルを使用します。
  
  • DBConnector_HiRDB_Type4_CP.rar
  • DBConnector_HiRDB_Type4_XA.rar
  RARファイルの種類に応じて，指定できるトランザクションサポートレベルが異なります。また，ライトトランザクションを使用できるかどうかも異なります。
  RARファイルごとに指定できるトランザクションサポートレベルを次の表に示します。
  

  表3-26　RARファイルごとに使用できるトランザクションサポートレベル（HiRDB Version 9）

  使用するDB Connector （RARファイル）	トランザクションサポートレベル	ライトトランザクション
  		有効	無効
  DBConnector_HiRDB_Type4_CP.rar	NoTransaction LocalTransaction	○	○
  DBConnector_HiRDB_Type4_XA.rar	XATransaction	−	○

  （凡例）　○：使用できる　　−：該当しない

  
  

HiRDBと接続する場合の注意を次に示します。

• HiRDBの自動再接続機能を使用すると，データベースネットワーク障害などでHiRDBサーバとの接続が切断された場合に，コネクションが自動的に再接続されます。ただし，トランザクション中に接続が切断されると，SQLException例外が発生します。J2EEアプリケーションでSQLException例外を受け取ったときには，処理を続行しないでください。続けてDBMSにアクセスするとデータの不整合などの問題が発生するおそれがあります。
• コネクションプール機能とステートメントプーリング機能を有効にして，Statement.cancel()を使用すると，SQLException例外が発生することがあります。この場合，コネクションプール機能，またはステートメントプーリング機能のどちらかを無効にすることをお勧めします。
• HiRDBのバージョンが07-01以前で，トランザクションサポートレベルにXATrasactionを使用する場合，トランザクション外でコネクションを使用してデータベースにアクセスすると，コネクションが二つ使用されます。
  HiRDBのバージョンが07-02以降で，J2EEアプリケーションが次の条件をすべて満たす場合は，コネクションが二つ使用され，HiRDBへの接続が同時に利用しているユーザ数の2倍になります。HiRDBのシステム共通定義のpd_max_usersオペランドに，同時に利用しているユーザ数の2倍の値を指定してください。pd_max_usersオペランドについては，マニュアル「HiRDB システム定義」を参照してください。
  
  1. トランザクションサポートレベルがXATrasactionのDB Connectorを使用する。
  2. アプリケーションサーバが管理するトランザクション内でコネクション^※を使ってデータベースにアクセスする。
  3. 2.のトランザクションが決着する前に，トランザクション外でコネクション^※を使ってデータベースにアクセスする。
     注※　このコネクションは1.のDB Connectorから取得したコネクションで，かつ同一コネクションです。
     
• HiRDBのバージョンが07-01以前で，ステートメントプーリング機能を有効にした場合，アプリケーションサーバが管理するトランザクションで使用するときだけ，ステートメントプーリング機能が使用できます。これ以外の場合はエラーが発生します。
  HiRDBのバージョンが07-02以降で，J2EEアプリケーションが次の条件をすべて満たす場合は，エラーが発生します。
  
  1. トランザクションサポートレベルがXATrasactionのDB Connectorを使用する。
  2. アプリケーションサーバが管理するトランザクション内でコネクション^※を使ってデータベースにアクセスする。
  3. 2.のトランザクションが決着する前に，トランザクション外でコネクション^※を使ってデータベースにアクセスする。
     注※　このコネクションは1.のDB Connectorから取得したコネクションで，かつ同一コネクションです。
     
• コネクションの障害検知機能が有効な場合，コネクションが正常のときにも障害であると誤診することがあります。その結果，不要なコネクションの破棄および生成が行われ，性能に影響が出ます。トランザクションサポートレベルがXATransactionのDB Connectorを使用してHiRDBに接続する場合はコネクションの障害検知機能を使用しないでください。障害が発生した場合は，cjclearpoolコマンドを実行してください。HiRDBのバージョンが07-02以降の場合は，コネクションの障害検知機能を使用できます。
• 次の条件をすべて満たす場合，同一コネクションを複数の異なるグローバルトランザクションに同時に参加させることはできません。トランザクションごとに使用するコネクションを分けてください。
  
  1. トランザクションサポートレベルがXATrasactionのDB Connectorを使用する。
  2. アプリケーションサーバが管理するトランザクション内でコネクション^※を使ってデータベースにアクセスする。
  3. 2.のトランザクションが決着する前に，トランザクション外でコネクション^※を使ってデータベースにアクセスする。
     注※　このコネクションは1.のDB Connectorから取得したコネクションで，かつ同一コネクションです。
     
• HiRDBのコネクション自動再接続機能およびステートメントプール機能を有効にすると，自動再接続機能によってコネクションが再接続されたあとのSQL実行でメッセージ「KFPA11901-E」を含んだSQLException例外が発生することがあります。トランザクションサポートレベルがLocalTransaction，またはNoTransactionのDB Connectorでステートメントプール機能を有効にしてHiRDBに接続する場合は，HiRDBのコネクション自動再接続機能は使用しないでください。障害が発生した場合は，コネクションの障害検知機能，またはcjclearpoolコマンドを実行してください。