JDBCデータソースを利用する際の注意制限事項について説明します。

• Linux版のOracle 8.1.7のJDBCドライバは、JTAをサポートしていません。データソースタイプに"JDBC"を指定することで、JDBCデータソースのJTA機能を利用してください（データソースタイプ"JDBC"のコネクションは、１つのトランザクション内で１つだけ利用できます）。または、JDBCドライバとしてSequeLinkを使用してください。
   
  
• OracleのDataSourceを使用してJTA連携を行う場合は、Oracleのサーバ側にJServerまたはOracle JVMをインストールしておく必要があります。運用編（障害解析）の「Oracle でのトランザクション障害への対応」を参考にしてインストール状況を確認してください。
   
  
• OracleのDataSourceを使用してJTA連携を行う場合は、Oracleのトランザクション制御用のテーブルへの適切なアクセス権設定を行う必要があります。運用編（障害解析）の「Oracle でのトランザクションリカバリ障害への対応」を参考にしてアクセス権設定を行ってください。
   
  
• Oracle10gのJDBCドライバを使用してデータベースとの接続を行う場合に、java.lang.ExceptionInInitializerError が発生することがあります。発生した場合には、運用編（障害解析）の「Oracle でのセキュリティ障害への対応」を参考にして障害解析を行ってください。
   
  
• バージョン9.0.1以前のOracleのDataSourceを使用し、JTA連携を行う場合は、必ず、グローバルトランザクションを開始してからSQL命令を実行してください。
   
  
• OracleのOCI JDBCドライバを使用するためには、次の設定を行ってください。

  OS	設定
  Windowsの場合	環境変数PATHに、%ORACLE_HOME%\binディレクトリを追加してください。
  HP-UXの場合	環境変数SHLIB_PATHに、$ORACLE_HOMEのlib32ディレクトリ（無い場合、または、IPF版ではlibディレクトリ）を追加してください。 Oracleの、環境変数ORACLE_HOMEとNLS_LANGの設定を行ってください。 これらの環境変数は、/etc/WebOTX/otx.conf に追記してください。 ※WebOTX運用ユーザに対する、$ORACLE_HOMEのlib32ディレクトリ（無い場合、または、IPF版ではlibディレクトリ）およびライブラリへの参照権(r)、実行権(x)が必要です。 ※/etc/WebOTX/otx.confの詳細は、「運用編(運用管理の概要)」の 2.4.7. otx.conf を参照してください。
  SolarisとLinuxの場合	環境変数LD_LIBRARY_PATHに、$ORACLE_HOMEのlib32ディレクトリ（無い場合はlibディレクトリ）を追加してください。 Oracleの、環境変数ORACLE_HOMEとNLS_LANGの設定を行ってください。 これらの環境変数は、/etc/WebOTX/otx.conf に追記してください。 ※WebOTX運用ユーザに対する、$ORACLE_HOMEのlib32ディレクトリ（無い場合はlibディレクトリ）およびライブラリへの参照権(r)、実行権(x)が必要です。 ※/etc/WebOTX/otx.confの詳細は、「運用編(運用管理の概要)」の 2.4.7. otx.conf を参照してください。

  
   
  
• OracleのDaraSourceを使用してJTA連携を行う場合は、Oracleの接続時ロードバランス機能をサポートしません。トランザクションを実行したOracleサーバとは別のOracleサーバに対してコミットが発行されてしまうことがあるためです。そのため、"jdbc:oracle"で始まるJDBC URLに記述したアドレス情報の順序でフェールオーバ接続を行うようにしてください。または、6.9.その他の注意・制限事項の内容をご確認の上、データソースタイプとして"JDBC"を指定してください。
   
  
• Oracle11gのDataSourceを使用する場合に、コネクションプール機能が正常に動作しないことがあります。本問題に対する回避策などは、KROWN(ORACLE技術情報ページ)#126806にて公開されています。
  
  （ご参考）
      KROWNは以下のURLにて確認可能です。
          http://support.oracle.co.jp/
      ※確認するには、事前に保守締結が必要です。
  
  上記情報の確認ならびに回避策であるパッチの入手方法につきましては、ORACLE製品保守締結を前提に購入元のベンダーに問合せください。
  
  または、6.9.その他の注意・制限事項の内容をご確認の上、データソースタイプとして"JDBC"を指定してください。

• 初期バージョンのSequeLink 5.0（日本語版）は、HP-UX上で動作しません。US版のSequeLink 5.2に対応したSequeLink 5.0（日本語版）の最新バージョンをご使用ください。詳細は、DataDirect Technologies社にお問い合わせください。

• 複数のアプリケーションプロセス（JavaVM）から、同じデータベースに対して同時にアクセスすることはできません。
   
  
• １つのアプリケーションプロセスから複数のJDBCコネクションを使用して同じデータベースにアクセスする場合、networkProtocolプロパティの値（"rmi"か指定なし）を全て同じにしてください。
   
  
• CloudscapeのDataSourceを使用し、networkProtocolプロパティの値として"rmi"を使用する場合、J2EE 1.3にバンドルされていたバージョン4.0以降のCloudscapeをご利用ください。
   
  
• UNIX上でデータベースファイルに直接アクセスする場合（networkProtocolプロパティの値に何も設定しない場合）、アプリケーションプロセス終了時にプロセス間排他制御を行うためのロックファイルが残ったままとなります。そのままアプリケーションプロセスを起動すると、最初のJDBCコネクション取得時にWarningメッセージが標準出力に出力されます。これを回避するためには、アプリケーションプロセスの終了時にデータベースのshutdownを実施してください。データベースのshutdownを行うためには、接続文字列として"jdbc:cloudscape:db名;shutdown=true"を使用してJDBCコネクションを取得してください。
   
  
• UNIX上でCloudscapeをご利用になる場合、データベースファイルへのアクセス権の関係で、アプリケーションプロセスやCloudscapeのRmiJdbcサーバからデータベースファイルにアクセスできないことがあります。アクセス権をご確認頂き、必要に応じてアクセス権の変更を行ってください。
   
  

• SybaseのDataSourceを使用してJTA連携を行う場合は、Sybase Adaptive Server EnterpriseのDTMオプションライセンスをインストールしてください。
   
  
• SybaseのDataSourceを使用してJTA連携を行う場合は、sp_configureコマンドで、"enable_dtm"パラメータの値を 0 から 1(on) に変更してください。
   
  
• SybaseのDataSourceを使用してJTA連携を行う場合は、sp_configureコマンドで、"dtm detach timeout period"パラメータの値を 0 から一定の値（例えばトランザクションのタイムアウト値以上の値）に変更してください。この値を変更しないと、トランザクションが残ってしまうことがあります。
   
  
• SybaseのDataSourceを使用してJTA連携を行う場合は、分散トランザクションに参加する全てのユーザに"dtm_tm_role"権限を付与してください。

• Microsoft SQL ServerのDataSourceを使用してJTA連携を行う場合は、Transactionサービス(Recovery Coordination Server)を使用してください。
   
  
• Microsoft SQL Server 2000のDataSourceを使用してJTA連携を行う場合は、SQL Server 2000 Driver for JDBCのJDBC XA Proceduresをインストールしてください。
   
  
• Microsoft SQL Server 2005のDataSourceを使用してJTA連携を行う場合は、Microsoft分散トランザクションコーディネータ(MS DTC)と連携するためのMS DTCインタフェースとして、Microsoft SQL Server 2005のsqljdbc_xa.dllとxa_install.sqlのインストールが必要です。

• java.sql.Connectionインタフェースのcommitやrollbackメソッドの呼び出し漏れがないようにしてください。呼び出し漏れがあると、java.sql.Connection.closeメソッド呼び出しが失敗し、JDBCコネクションの状態が使用中のままになります。

• PostgreSQLでJTA連携を行うためには、PostgreSQL 8.1.0以降、8.3.0までのデータベースと、バージョン8.1-404 〜 バージョン8.3dev-601のJDBCドライバを使用する必要があります。それより前のバージョンのJDBCドライバを使用する場合は、データソースタイプに"JDBC"を指定してJDBCデータソースのJTA機能を利用してください。
   
  
• データソースタイプ"JDBCEX_PostgreSQL"のコネクションは、１つのトランザクション内で１つだけしか利用できません。このため、トランザクションに参加するアプリケーションでは、そのアプリケーションの処理や、アプリケーションから利用するフレームワークやユーティリティクラスなどにおいて、コネクション取得を何度も行わないように注意する必要があります。

• 特にありません。
   
  

• データソースタイプに"JDBC"を指定してJTAと連携する場合、データソースタイプ"JDBC"のコネクションは、設定内容の違いを問わず、１つのトランザクション内で１つだけしか利用できません。このため、データソースタイプ"JDBC"のコネクションだけで２フェーズコミットを行うことはできません。例えば、ACOS Access ToolkitのJDBCドライバと一緒に、データソースタイプ"JDBC"ではないOralceのDataSourceを利用することで、２フェーズコミットを実施することができます。
   
  
• データソースタイプ"JDBC"のコネクションに対するコミットが失敗した場合の結果は、通常ロールバックされた状態になりますが、データベースサーバ側でのコミット処理完了後に通信障害が発生した場合など、稀にコミットされていることがあります。対策としては、autoRecoveryOnOnePhaseCommitプロパティにfalseを設定することで自動的にロールバックされないようにしておき、コミットの結果をJDBCドライバやデータベースが提供する運用操作や例外メッセージに従って確認した上で、トランザクションを復旧してください。トランザクションの復旧操作については、運用編（Transaction サービスの運用操作）を参照してください。
   
  
• java.sql.Statement.getConnectionメソッドで返却されたjava.sql.ConnectionのsetAutoCommitメソッドを呼び出さないでください。呼び出すと、JDBCデータソースによるautoCommitモードの自動変更が正しく行われません。
   
  
• データソースタイプが"JDBC"の場合に、java.sql.Statement.getConnectionメソッドで返却されたjava.sql.Connectionのcloseメソッドを呼び出すと、JDBCコネクションは物理的に切断されます。また、解放されないことがあります。
   
  
• データソースタイプが"JDBC"の場合は、TransactionサービスのJDBCリソースとして登録しないでください。JTAのインタフェースの一部を実装していないため、Transactionサービスによるトランザクションのリカバリ処理で必ずエラーが発生します。
   
  
• 各JDBCドライバのリファレンスやREADMEファイルを必ず参照し、JDKの対応バージョンや注意・制限事項等をご確認ください。