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. 次のいずれかの操作を実行して、データベースベンダーを指定します。
  6. 「次へ」をクリックします。

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

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

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

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

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

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

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

  10. 「説明」フィールドに、接続プールの簡単な説明を入力します。
  11. 「初期および最小プールサイズ」フィールドに、このプールの最小接続数を入力します。

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

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

    デフォルト値は 32 です。

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

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

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

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

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

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

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

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

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

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

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

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

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

  19. (省略可能) 「追加プロパティー」セクションで、追加プロパティーを指定します。

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

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

    ()
  20. 「完了」をクリックします。

参照

Copyright © 2005, 2011, Oracle and/or its affiliates. All rights reserved. 著作権について