ページの先頭行へ戻る
Interstage Application Server/Interstage Web Server Express Java EE運用ガイド(Java EE 6編)
FUJITSU Software

4.14.11 Ping機能

本製品では、接続プールに設定した定義情報でデータベースへアクセスできるかを確認するためのPing機能を提供します。以下の方法で利用できます。

注意

  • Ping機能ではデータソースクラスに対してgetConnectionメソッドを実行してデータベースへアクセスできるかを確認するため、データベースにアクセスするために使用されないプロパティについてはチェックされない場合があります。

  • Ping機能ではデータベースから接続を取得することに失敗した場合、自動再接続を行いません。

  • Ping機能を使用する時、JDBC接続プールの追加プロパティuserおよびpasswordにユーザIDとパスワードを指定してください。

  • 接続プールの定義情報を更新した場合には、Interstage Java EE 6 DASサービスを再起動してください。

  • 接続検証が有効、かつ検証方法にtableが指定された場合、テーブル名で指定されたテーブルが該当のデータベースに存在しない場合は接続テストに失敗します。あらかじめ、指定したテーブルを作成した上で実行してください。

  • 接続プールのトランザクション遮断属性にデータベースがサポートしないトランザクション遮断レベルを指定した場合、接続テストに失敗します。詳細は、JDBCドライバのマニュアルを参照してください。

  • 接続テストに失敗した場合は、「Ping failed Exception -」以降の例外情報を参照して原因を取り除いてください。
    特に、以下のようなクラスやライブラリが見つからないエラーや、JDK/JREとクラスファイルのバージョンの組み合わせが正しくないエラーが発生する場合には、クラスパスやネイティブライブラリパスの設定に不足や誤りがないか見直してください。JDK/JREとJDBCドライバのバージョンの組み合わせは各データベースのマニュアルを参照してください。

    • java.lang.NoClassDefFoundError

    • no ライブラリ名 in java.library.path

    • Bad version number in .class file

  • Oracle OCIドライバを使用する場合は、環境変数ORACLE_HOMEを設定してください。ORACLE_HOMEを設定せずに接続テストを実行した場合、OCIドライバの仕様によりInterstage Java EE 6 DASサービスが停止する可能性があります。誤って実行した結果、Interstage Java EE 6 DASサービスが停止した場合は、サービスを再度起動してください。

  • JDBCドライバが提供する接続プールを使用する場合、Ping機能で接続テストが成功すると、接続がプールに残存します。Ping機能実行後は、プールに残存した接続を解放するためにInterstage Java EE 6 DASサービスを再起動してください。