12.9. データベース接続の検証

validate-on-match メソッドが true に設定されている場合は、データ接続が、次の手順で指定された検証メカニズムを使用して接続プールからチェックアウトされるたびに検証されます。

接続が有効でない場合は、警告がログに書き込まれ、プール内の次の接続が取得されます。このプロセスは、有効な接続が見つかるまで続行します。プール内の各接続を繰り返し処理しない場合は、use-fast-fail オプションを使用できます。有効な接続がプールにない場合は、新しい接続が作成されます。接続の作成に失敗すると、例外が要求元アプリケーションに返されます。

background-validation メソッドを true に設定すると、使用前にバックグラウンドスレッドで接続が周期的に検証されます。検証の頻度は background-validation-millis プロパティーによって指定されます。background-validation-millis のデフォルト値は 0 で、無効になっています。

以下を考慮して background-validation-millis プロパティーの値を決定してください。

検証メカニズムとして valid-connection-checker-class-name を使用することが推奨されます。これは、使用中のデータベースの接続を検証するために使用される接続チェッカークラスを指定します。JBoss EAP は以下の接続チェッカーを提供します。

check-valid-connection-sql を使用して、接続の検証に使用する SQL ステートメントを提供します。

以下は、Oracle の接続を検証するために使用する SQL ステートメントの例になります。

select 1 from dual

以下は、MySQL または PostgreSQL の接続を検証するために使用する SQL ステートメントの例になります。

select 1