データベース接続プールの設定は、システムとデータベースとの効率的で安定した接続を確保するための重要なステップです。適切な接続プールの設定により、データベース接続数を効果的に管理し、高同時実行による接続枯渇問題を回避するだけでなく、適切なタイムアウト設定により無効な接続をタイムリーにクリーンアップし、システム性能を確保できます。
本記事では、接続プールパラメータの推奨設定およびJDBC設定の重要なパラメータについて紹介します。これにより、開発者がデータベースアクセスを最適化するのに役立ちます。
接続プールパラメータ
接続プール設定の推奨事項
管理コンソールでは、通常、最小接続数(min)を2に設定すれば十分です。具体的な調整は、業務の並行性とトランザクション時間に応じて行ってください。
接続のアイドルタイムアウト時間を設定します。30分を推奨します。
MySQLのデフォルトでは、アイドル状態が8時間続くと接続は自動的に切断され、クライアント側では検知できないため、無効な接続が残ります。接続プールは、ハートビートやtestOnBorrowなどのメカニズムを通じて接続が有効かどうかを確認し、この時間を超えて接続が使用されない場合は直接切断します。
JDBCの構成パラメータ
JDBCの重要なパラメータは、必ず設定する必要があります。すべて、接続プールのConnectionPropertiesまたはJdbcUrlに設定できます。具体的なパラメータとその説明は以下の表のとおりです。
パラメータ |
説明 |
|---|---|
| socketTimeout | ネットワークソケットのタイムアウトをミリ秒単位で定義します。値が0の場合、タイムアウト制限がないことを意味します。デフォルト値:0(標準設定)。 |
| connectTimeout | 接続タイムアウトをミリ秒単位で指定します。値が0の場合、タイムアウト制限がないことを意味します。デフォルト値:30000。 |
JDBC設定例
本記事では、JDBC設定の例を紹介します。
JDBCを使用してデータベースに接続する際には、関連パラメータを設定してデータベースの最適なパフォーマンスを得る必要があります。ここでは、関連するパラメータの設定例をいくつか推奨します。
JDBC接続の例は以下のとおりです:
conn=jdbc:oceanbase://xxx.xxx.xxx.xxx:3306/test?rewriteBatchedStatements=TRUE&allowMultiQueries=TRUE&useLocalSessionState=TRUE&useUnicode=TRUE&characterEncoding=utf-8&socketTimeout=10000&connectTimeout=30000
この接続で使用する構成パラメータは次のとおりです。
rewriteBatchedStatements:TRUEに設定することを推奨します。OceanBaseのJDBCドライバはデフォルトでexecuteBatch()ステートメントを無視し、一括実行されるSQLステートメントのセットを分解して、一つずつデータベースに送信します。この場合、バッチ挿入は実際には単一挿入となり、性能が低下します。実際にバッチ挿入を実行するには、このパラメータをTRUEに設定する必要があります。そうするとドライバはSQLをバッチ実行します。addBatchメソッドを使用して、同一テーブル上の複数のinsertステートメントを一つのinsertステートメント内の複数のvalues値としてまとめることで、batch insertの性能を向上させます。
すべてのinsertをprepareStatement方式でprepareし、その後にaddBatchする必要があります。そうでない場合、結合実行はできません。
allowMultiQueries:TRUEに設定することを推奨します。JDBCドライバは、アプリケーションコードが複数のSQLをセミコロン(;)で結合し、一つのSQLとしてサーバー側に送信することを許可します。
useLocalSessionState:トランザクションが頻繁にOBデータベースにセッション変数のクエリSQLを送信するのを避けるため、TRUEに設定することを推奨します。セッション変数は主に以下のものです:autocommit、read_only、およびtransaction isolation。
socketTimeout:SQL実行時に、ソケットがSQLの実行結果を待機する時間です。connectTimeout:接続確立時に、接続が確立されるまで待機する時間です。useCursorFetch:TRUEに設定することを推奨します。データ量の多いクエリステートメントでは、データベースサーバーがCursorを作成し、FetchSizeに応じてクライアントにデータを配信します。このプロパティを
TRUEに設定すると、useServerPrepStms=TRUEも自動的に設定されます。useServerPrepStms:PSプロトコルを使用してSQLをデータベースサーバーに送信するかどうかを制御します。TRUEに設定すると、SQLはデータベース内で2段階に分けて実行されます:?を含むSQLテキストをデータベースサーバーに送信し、Prepareを実行します(SQL_audit: request_type=5)。実際の値を指定し、データベース側でSQLを実行します(
SQL_audit: request_type=6)。
cachePrepStmts:JDBCドライバーがPSキャッシュを有効にしてPreparedStatementをキャッシュし、prepareの繰り返し実行(client側およびserver側)を回避するかどうかを制御します。cachePrepStmts=TRUEは、useServerPrepStms=TRUEを使用し、同一SQLに対してバッチ実行を繰り返すシナリオに役立ちます。バッチ実行には毎回prepareとexecuteが含まれますが、cachePrepStmts=TRUEを設定するとprepareの繰り返しを回避できます。prepStmtCacheSQLLimit:PSキャッシュに格納できるSQLの最大長制限です。長すぎるSQLはキャッシュに入れることができません。prepStmtCacheSize:PSキャッシュが保存できるSQLの数です。maxBatchTotalParamsNum:バッチ操作において、1つのSQLがサポートできるパラメータの最大数(バッチ内の?の数)です。パラメータ数がこの制限を超える場合、バッチSQLは分割されます。