ページの先頭行へ戻る
Interstage Application Server/Interstage Web Server Java EE運用ガイド

5.14.7 Ping機能

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

注意

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

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

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

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

  • 接続テストに失敗した場合は、「Target exception message:」以降の例外情報を参照して原因を取り除いてください。
    特に、以下のようなクラスやライブラリが見つからないエラーや、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 DASサービスが停止する可能性があります。誤って実行した結果、Interstage Java EE DASサービスが停止した場合は、サービスを再度起動してください。