JDBC接続プールを作成する

管理コンソールで接続プールを作成すると、特定のデータベースへの接続の項目を定義することになります。

開始する前の準備

接続プールを作成するには、JDBC APIをサポートするドライバ(JDBCドライバ)を最初にインストールし、統合する必要があります。JDBCドライバを統合するを参照してください。

JDBC接続プールの作成には次の情報が必要です。続行する前にこの情報を収集してください。

  1. ナビゲーション・ツリーで、「共通タスク」ノードを選択します。

    「共通タスク」ページが開きます。

  2. 「共通タスク」ページで、「新しいJDBC接続プールを作成します」ボタンをクリックします。

    「新しいJDBC接続プール(ステップ1/2)」ページが開きます。


    注意:

    「リソース」ノードおよび「JDBC」ノードを展開し、「接続プール」ノードを選択して、「新しいJDBC接続プール」ページにアクセスすることもできます。次に、「接続プール」ページで、「新規」を選択して新しい接続プールを作成します。
  3. 「プール名」フィールドに、新しい接続フィールドの名前を入力します。

    このフィールドは必須です。

  4. 「リソース・タイプ」ドロップダウン・リストから、リソース・タイプを選択します。

    選択できるのは、javax.sql.XADataSource(グローバル・トランザクション)、java.sql.ConnectionPoolDataSource(ローカル・トランザクション、パフォーマンス改善が可能)、javax.sql.DataSource(ローカル・トランザクションのみ)、およびjava.sql.Driverです。

  5. データベース・ベンダーを指定します。

    1. 「データベース・ドライバのベンダー」ドロップダウン・リストから、データベース・ベンダーを選択します。

    2. データベース・ベンダーがリストに表示されない場合は、「データベース・ドライバのベンダー」テキスト・フィールドにベンダーの名前を入力します。

  6. 「イントロスペクション」の「有効」チェックボックスを選択して、データソースまたはドライバ実装クラス名に基づいたデータベース・ドライバをイントロスペクトします。

  7. 「次」をクリックします。

    「新しいJDBC接続プール(ステップ2/2)」ページが開きます。

  8. 「データソース・クラス名」フィールドに、DataSourceConnectionPoolDataSource、またはXADataSourceのAPIを実装するベンダー固有のクラス名を入力します。

    データソース・リソース・タイプのいずれかを選択した場合、通常このフィールドには、選択したリソース・タイプとデータベース・ベンダーに関連付けられたクラス名が自動的に入力されます。java.sql.Driverリソース・タイプを選択した場合、このフィールドは無効になります。

  9. 「ドライバ・クラス名」フィールドに、java.sql.Driver APIを実装するベンダー固有のクラス名を入力します。

    java.sql.Driverリソース・タイプを選択した場合、通常このフィールドには、選択したドライバとデータベース・ベンダーに関連付けられたクラス名が自動的に入力されます。データソース・リソース・タイプのいずれかを選択した場合、このフィールドは無効になります。

  10. 「Ping」の「有効」チェックボックスを選択して、プールの作成または再構成時にプールに対して自動的にpingを実行し、誤った属性値を識別および警告します。

    このオプションは、デフォルトでは無効になっています。

  11. 「説明」フィールドに、接続プールの簡単な説明を入力します。

  12. 「初期および最小プール・サイズ」フィールドに、このプールの最小接続数を入力します。

    この値は、プールを最初に作成したり、GlassFish Serverを起動したときの、プールに含まれる接続の数も判定します。デフォルト値は8です。

  13. 「最大プール・サイズ」フィールドに、このプールの最大接続数を入力します。

    デフォルト値は32です。

  14. 「プール・サイズ変更量」フィールドに、プール・サイズの変更バッチごとの接続数を入力します。

    プールのサイズを最大プール・サイズおよび最小プール・サイズに対してスケール・アップおよびスケール・ダウンすると、一括処理でプール・サイズが変更されます。この値は一括処理での接続の数を指定します。この値を過大に設定すると接続の作成と再利用が遅れ、過小に設定すると効率が落ちます。デフォルト値は2です。

  15. 「アイドル・タイムアウト」フィールドに、接続がプール内にアイドル状態で残ることができる最大時間を秒単位で入力します。

    この時間を過ぎると、接続はプールから削除されます。デフォルト値は300です。

  16. 「最大待機時間」フィールドに、接続をリクエストしているアプリケーションが接続タイムアウトを受け取るまでに待機する最長時間をミリ秒単位で入力します。

    デフォルト値は60,000です。

  17. 「非トランザクション接続」の「有効」チェックボックスを選択して、非トランザクション接続を返すようにします。

    このオプションは、デフォルトでは無効になっています。

  18. 「トランザクション遮断」の「レベル」ドロップダウン・リストから、この接続プールのトランザクション分離レベルを選択します。

    指定しない場合、接続にはJDBCドライバによって設定されるデフォルトの分離レベルが適用されます。デフォルトでは、このオプションは指定されていません。

  19. 「分離レベル」の「保証付き」チェックボックスを選択して、プールから取得されるすべての接続が同じ分離レベルになることを保証します。

    たとえば、最後の使用時にcon.setTransactionIsolationを使用して接続の分離レベルをプログラム的に変更した場合、このメカニズムによってステータスが指定の分離レベルに戻されます。このオプションはデフォルトで有効になっています。

    この設定が適用されるのは、トランザクション分離レベルが指定された場合のみです。

  20. 「追加プロパティ」セクションで、追加プロパティを指定します。

    必須プロパティの具体例は、データベース名(URL)、ユーザー名、パスワードなどです。通常、表にはデータベース・ベンダーが使用するプロパティが含まれます。使用可能なプロパティの詳細は、JDBC接続プールに固有のプロパティを参照してください。

    プロパティの値を指定しない場合は、接続プールの作成が終了したときにプロパティが表から削除されます。プロパティの値をすぐに設定せず、後で設定できるように表内に残す場合は、「値」フィールドに空の括弧を入力します。

    ()
    
  21. 「終了」をクリックします。

関連項目
Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices