PolarDB:接続プール

セッションレベル接続プール

アプリケーションの接続が閉じられると、PolarProxy はその接続がアイドル状態かどうかを確認します。アイドル状態の場合、PolarProxy は短時間の間、その接続をプール内に保持します。user、clientip、および dbname パラメーターが一致する次の受信リクエストは、そのアイドル接続を再利用し、新しい接続を開くコストを節約します。一致する接続が見つからない場合、PolarProxy はデータベースに対して新しい接続を開きます。

セッションレベルプールは接続確立の頻度を削減し、消費される MySQL メインスレッド数を減らしてスループットを向上させます。ただし、同時接続数の合計は削減されません。アイドル状態のプール接続もデータベースの接続制限にカウントされます。

トランザクションレベル接続プール

トランザクションレベルプールは、データベースへの直接接続数と短時間接続によるオーバーヘッドの両方を削減します。アプリケーションは PolarProxy に対して数千もの接続を開くことができますが、PolarProxy はバックエンドデータベースに対して数十〜数百の接続しか維持しません。

アプリケーションがリクエストを送信すると、PolarProxy はすぐにバックエンド接続を開きません。代わりに、プール内で user、dbname、およびシステム変数（sql_mode、character_set_server、collation_server、time_zone）が一致するアイドル接続を検索します。一致する接続が存在する場合、PolarProxy はそれを再利用します。トランザクションが完了すると、接続はプールに戻され、他のリクエストで使用可能になります。

PolarProxy はアプリケーション側の接続数に制限を設けません。PolarDB クラスターエンドポイントへの最大接続数は、バックエンドコンピュートノードの仕様によって決まります。トランザクションレベルプールを使用しない場合、システムはすべてのリクエストに対してプライマリノードおよび各読み取り専用ノードに個別の接続を開く必要があります。

セッションレベルの制限事項

• セッションレベルプールは同時実行数ではなく接続頻度を削減します。プール内のアイドル接続もデータベースの合計接続制限にカウントされます。

• セッションレベルプールは、スロー SQL 文によって引き起こされる保留中の接続を解決しません。

トランザクションレベルの制限事項

以下の操作はセッションの継続中に接続をロックします。ロックされた接続はプールに戻されず、他のリクエストで使用できなくなります。

サポートされていない関数

FOUND_ROWS()、ROW_COUNT()、および LAST_INSERT_ID() は呼び出せますが、接続が再利用される際に不正確な結果を返す可能性があります。

その他の動作の違い

• `wait_timeout`：タイムアウトが経過すると、バックエンド接続のみが閉じられます。アプリケーション側の PolarProxy への接続は開いたままになります。これは、PolarProxy が各新しいリクエストに対してプールから接続を選択するためです。

• セッション変数：プールは sql_mode、character_set_server、collation_server、および time_zone を使用して接続を照合します。リクエストがこれらの変数以外のセッションレベルシステム変数に依存する場合、各接続確立後に SET 文を実行してそれらを設定してください。そうしないと、予期しない変数値を持つ接続が再利用される可能性があります。

• 分離レベル：デフォルトの READ COMMITTED 分離レベルを維持してください。クライアントが明示的に分離レベルを変更した場合、トランザクション終了後に接続はプールに戻され、他のリクエストで再利用される可能性があり、分離レベルの一貫性が失われるおそれがあります。

• `SELECT connection_id()`：接続がリクエスト間で再利用されるため、同じ接続のように見えても異なるスレッド ID を返す可能性があります。

• `SHOW PROCESSLIST` および SQL Explorer：接続が PolarProxy を通じて多重化されるため、表示される IP アドレスおよびポート番号は、アプリケーションの実際の IP アドレスおよびポートと異なる場合があります。

• `KILL` コマンド：ERROR 1094 (HY000): Unknown thread id: xxx が返されます。これは、クライアントと PolarProxy 間のスレッド ID が、PolarProxy とデータベース間のスレッド ID と異なるためです。PolarProxy は、すべてのノードからの SHOW PROCESSLIST の結果をマージしてからクライアントに返します。