本記事では、接続プールの構成パラメータについて説明します。ZDALパラメータ、Druidパラメータ、DBCPパラメータ、C3P0パラメータ、およびJDBCパラメータなどが含まれます。
データソース構成パラメータ
設定項目 |
説明 |
ZDALパラメータ |
Druidパラメータ |
DBCP 2パラメータ |
C3P0パラメータ |
|---|---|---|---|---|---|
| 初期接続数 | 接続プール初期化時に確立する接続数。 | prefill=true の場合、minConn に初期化 | initialSize |
initialSize |
initialPoolSize(3) |
| 最小接続数 | 使用可能な最小接続数。これにより、接続プールは常にこの数の接続を維持します。 | minConn(0) | minIdle |
minIdle |
minPoolSize(3) |
| 最大接続数 | 接続プールがアプリケーションに同時に割り当て可能な最大接続数。 | maxConn(10) | maxActive |
maxTotal |
maxPoolSize(15) |
| 接続アイドルタイムアウト時間 | 長時間使用されていない接続を接続プールから削除します。実際のネットワーク状況に応じて接続プールのアイドルタイムアウトを設定し、期限切れの接続の再利用を避けてください。 | idleTimeoutMinutes(30min) | minEvictableIdleTimeMillis |
minEvictableIdleTimeMillis |
maxIdleTime(0はタイムアウトなし) |
| プールからの接続取得時のタイムアウト | 設定が大きすぎると、接続プールが満杯のときに、アプリケーションの応答が遅くなる可能性があります。 | blockingTimeoutMillis(500ms) | maxWait |
maxWaitMillis |
checkoutTimeout(0はタイムアウトなし) |
| 未返却の接続を破棄するまでの時間 | この時間内に接続が解放されない場合、接続プールに戻らずに直接破棄されます。接続リークを防ぐことができますが、トランザクションに使える時間も制限されます。 | なし | removeAbandonedTimeout |
removeAbandonedTimeout |
なし |
DruidとDBCP 2のパラメータの使い方については、Druidの例およびDBCPの例を参照してください。
JDBC構成パラメータ
JDBCの重要なパラメータは必ず設定する必要があります。すべて接続プールのConnectionPropertiesまたはJdbcUrlに設定できます。具体的なパラメータとその説明は以下の表のとおりです。
パラメータ |
説明 |
|---|---|
| socketTimeout | ネットワークソケットのタイムアウト(SO_TIMEOUT)をミリ秒単位で定義します。値が0の場合、このタイムアウトは無効になります。 デフォルト値:0(標準設定)。 |
| connectTimeout | 接続タイムアウト値で、ミリ秒単位です。値が0の場合、タイムアウト制限がないことを意味します。デフォルト値:30000。 |
接続プール設定の推奨事項
管理コンソールでは、通常、最小接続数を2に設定すれば十分です。具体的な数は、業務の同時実行数とトランザクション処理時間に応じて調整してください。
接続アイドルタイムアウト時間を設定することを推奨します。30分が適しています。
MySQLでは、デフォルトで8時間アイドル状態が続くと接続が切断されます。クライアント側でこの切断を検知できず、無効な接続が残ることがあります。接続プールは、ハートビートやtestOnBorrowなどのメカニズムを通じて接続の生存状態を検証し、この時間を超えて接続が使用されない場合は直接切断します。